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PREFACE 


The information contained in this document has not been submitted to 
any formal IBM test and is distributed on an ‘As Is" basis without any 
warranty either expressed or implied. The use of this information or the 
implementation of any of these techniques is a customer responsibility 
and depends on the customer's ability to evaluate and integrate them 
into the customer's operational environment. While each item may have 
been reviewed by IBM for accuracy in a specific situation, there 1s no 
guarantee that the same or similar results will be obtained elsewhere. 
Customers attempting to adapt these techniques to their own 
environments do so at their own risk. The samples described in this 
material are presented for illustrative purposes only and are not 
intended to be implemented as described. 


Any references made to an IBM licensed program in this document are 
not intended to state or imply that only IBM's licensed program may be 
used; any functionally equivalent program may be used instead. 


It is possible that this material may contain reference to, or 
information about, IBM products (machines and programs), programming 
or services that are not announced in your country. Such references 
or information must not be construed to mean that IBM intends to 
announce such IBM products, programming or services in your country. 
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CHAPTER 1. INTRODUCTION 


This document is the result of a project at the Raleigh International Sys- 
tem Center to install, test, and evaluate an early release of the Network 
Logical Data Manager (€ NLDM, program number 5668-971 ) program product. 
The access method used was ACF/VTAM V2R1 and this will be the only access 
method considered in this document. The job control and samples must be 
adjusted for each system. 


The intent of this paper is to ease the initial installation and use of 
NLDM V1R1 and try to give answers to the questions "how helpful 1s NLDM in 
the problem determination area, and how should it be used to solve a spe- 
cific problem?"™. 


NLDM operates with Network Communications Control Facility (NCCF) release 
2, With the appropriate PTFs. It uses system functions of NCCF to commu- 
nicate with the SNA access method, to collect data related to SNA 
sessions, and to communicate with the VSAM data base to store and retrieve 
historical session data. It also uses the cross-domain capability of NCCF 
to permit the display of data collected in remote NCCF domains that are 
also running NLDM VIRI1. 


The collected data includes information about session activation and 
deactivation, session partners, the physical configuration associated 
with the session, access method PIU data and NCP data. Figure 2 on page 3 
details the selected hardware resources for which tracing 1s provided and 
the type of data collected. For the active sessions the data 1s kept in 
virtual storage, while for terminated sessions the data is recorded in the 
NLDM data base as historical data. 


Therefore, NLDM collects and correlates data related to SNA sessions, 
gives the user on-line access to this information, and thus helps him to 
identify network problems. NLDM can be compared to existing TRACE capa- 
bilities, in the same way that NPDA can be compared to LOGREC. 


With the ability to view data from other domains, NLDM also provides a 
centralized problem determination facility. 


NLDM can coexist with the other NCCF products like NETWORK PROBLEM DETER- 
MINATION APPLICATION CNPDA), 3600 THRESHOLD ANALYSIS AND REMOTE ACCESS 
FEATURE CTARA), and TERMINAL ACCESS FACILITY (TAF). 


Hon to use this document: 


To learn how to operate NLDM read "CHAPTER 2. Using NLDM"™ on page 9 
and "CHAPTER 3. Session Tracing” on page 29. 


Read "CHAPTER 3. Session Tracing™ on page 29 and "CHAPTER 4. Network 
Control Center use of NLDM - Scenarios" on page 31 for examples of 
the practical use of NLDM. 


Information for installing NLDM is given in "CHAPTER 5. Installing 
NLDM™ on page 61 and "CHAPTER 6. Performance Considerations" on page 
71. 


For the definitions of some terms used, consult "Appendix F. Defi- 
nitions™ on page 89. 
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OPERATING ENVIRONMENT 


The environment in which NLDM operates is shown in Figure 1. 


NLDM operates under the control of NETWORK COMMUNICATIONS CONTROL FACILI- 
ie Ae Release 2 and is invoked by an NCCF operator at an NCCF 
ermina 


NLDM collects data relating to SNA sessions in single-domain and 
multi-domain networks in a wWrappable area in virtual storage for the 
active sessions, and recorded in a data base for the terminated sessions. 
It can trace all sessions of a given NAU which have an end point in the 
host, when the NAU is acting as either a primary or secondary end of the 
session (see "CHAPTER 3. Session Tracing" on page 29). NLDM also collects 
data relating to the data flows for certain non-SNA (FIDO) terminals (see © 
Figure 2 on page 3). For the NLDM cross-domain support, which allows a 
view of the session data of a partner residing in another domain, an NLDM 
seer be active in both domains and an NCCF to NCCF session must be 
started. 


NLDM gives an on-line hierarchical presentation of the collected data to 
the NLDM user. 


NCCF <——> OPER. 
SNA access method <——CTC————> SNA access method 
A-————_——_—_—— 


[ acr/wer 2 ce 
ACF/NCP <———> ACF/NCP 7 
nC eS REE 
> SNA access method 


Figure 1. NLDM ENVIRONMENT 


CNM processors controlled by NCCF may use NPDA and/or 
NLDM. 


The CTC attachment is provided only by ACF/VTAM V2. The 
MSNF feature is necessary for controlling multiple-domain 
networks if ACF/VTAM V1 is used. 


NLDM consists of a command processor that executes under the control of an 
NCCF Data Services Task (DST) anda set of command processors that operate 
under the control of an NCCF Operator Station Task (OST). There is one OST 
for each NCCF operator who logs on and, therefore, for each NLDM user (for. 
further information see "Appendix A. NLDM structure” on page 73). 


DATA COLLECTION 


The access method and the NCP do not provide session trace data until they 
receive an explicit request from NLDM. For remote NAU’S NCP trace data can 
only be obtained after NLDM receives a session anareness for the ACTPU of 
the corresponding NCP. For the resources added by dynamic reconfiguration 
or switched, since their addresses are dynamically assigned, tracing may 
be accomplished only if a global trace Was started from NLDM initializa- 
tion or by using the TRACE ALL command. 


It 31S important that NLDM be initialized before activating any network 


nodes for Which session awareness and/or session data 18 required. (see 
“Initialization” on page 9). 
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The user can allow NLDM to issue trace requests for all LU and SSCP ses- 
Sions as apart of the initialization process (CTRACELU,TRACESC 
parameters). Once NLDM initialization is accomplished the user 15 able to 
display and START/STOP data capture for specific NAU's CTRACE DISP and 
TRACE STOP/START commands). The maximum number of resource names that can 
have traces started or stopped is given by an initialization parameter 
(MAXTRACE). This parameter value does not affect the TRACE ALL command. 


NLDM maintains a wrap area in virtual storage for each active session. 
The size of the wrap area is an initialization parameter (KEEPPIU) and may 
be displayed and changed dynamically for each session by the user (CDISKEEP 
and KEEP commands). 


se5s510n session trace data 
RESOURCE awareness session 
data param.& PIUs| NCP data 


host LU APPL 


local SNA 
non—-SNA 


remote SNA 
non-SNaA 
CNCP attached) 
NTO 


DR added and 
SWITCHED 


Figure 2. NLDM RESOURCES and DATA TRACED 


NLDM collects and displays two types of session data (see Figure 2 for the 
type of data collected for each type of resource): 


° session awareness data which is collected each time ae session 
(SSCP-SSCP, SSCP-PU, SSCP-LU, LU-LU, non-SNA devices(FIDO0))! acti- 
vates successfully or terminates. Session awareness data is always 
traced if NLDM is active. The session awareness RU is time stamped by 

NLDM and consists of: 


a session partner names or CDRM names if the partner 1S a 
cross~domain resource 


= network addresses 

= session type 

aa configuration information about the primary and secondary ends 

These RU's will be discarded if NCCF is unavailable. NLDM can display 

data from the session awareness RU, even if the session data 15 not 

traced (Figure 6 on page 13): 

= session name List display 

= most recent sessions for a specific name display 

= configuration for a specific session display 

e session trace data which consists of: | 

= session activation parameters. This data is collected if at least 
one end point of the session is traced and only if the session is 
successfully activated. The data is taken from the SNA command 
used to activate the session CACTCDRM,ACTPU,ACTLU, BIND). 

_ access method PIU data. For a single domain session the PIU data 
is collected if at least one end point is traced, and only once if 


i SSCP-HOSTPU and PU-PU sessions are not supported 


CHAPTER 1. Introduction 3 


both ends are traced. For a multi-domain session the PIU data may 
be collected by the domain of the primary end of the session (see 
"CHAPTER 3. Session Tracing" on page 29) 


The PIU data includes the TH, RH and 11 bytes from the RU data. 


~ NCP data. This data is collected only for the remote resources and 
by the domain of the corresponding NCP (see "CHAPTER 3. Session 
Tracing™ on page 29). 


The NCP data consists of four PIU sequence numbers, the last two 
in and out Cexcept for the SSCP-LU and SSCP-PU sessions), and 
selected contents of appropriate control blocks that relate to 
the NCP resource involved in session. 


For FIDO devices see later in this chapter. 


DATA RECORDING 


Upon session termination or when requested by the user (FORCE command), 
the virtual storage wrap area is migrated to the NLDM VSAM data base as 
historical data. The amount of history is an NLDM initialization parameter 
(KEEPSES) and may be displayed and changed dynamically for each session by 
the user (DISKEEP and KEEP commands). 


The NLDM operator can change the amount of session history any time the 
corresponding session is active by means of the KEEP n SESS FOR name com- 
mand. This change will be permanently recorded in the data base whereas 
the KEEP n PIUS FOR name is temporary in nature and will revert back to the 
default initialization value once the current session is terminated. 


By issuing a FORCE command, session data is recorded using the data of the 
current session. The start time of the current session is modified to 
reflect the time the FORCE command was issued. Since VTAM buffers PIU 
trace data before sending the data to NLDM it is essential that the opera- 
tor display the relevant PIU trace data prior to using the FORCE command. 
This will ensure that NLDM requests VTAM to send the trace buffers so that 
any relevant PIU information is available to NLDM. If this is not done 
only the trace data currently in NLDM buffers is recorded on disk,» and 
this may not be the true position. 


Similarly the NCP data will be recorded only if it is in storage as a 
result of a user solicitation. 


It is extremely important, therefore, for the operator to SOLICIT both the 
PRIMARY and the SECONDARY trace data PRIOR to using the FORCE command. 


NLDM provides a Buffer Pending Queue (BPQ) and a Time Pending Queue CTPQ) 
to keep the information when several active sessions terminate ina very 
small period of time (5 seconds). The sizes of these queues are estab- 
lished at initialization by a parameter (MAXEND). 

NLDM can alternate the recording of session data between two VSAM data 
bases (NCCF SWITCH command). There 15 no automatic switching and no sup- 


port of the VSAM shared option. The structure of the NLDM data base is 
described in "Appendix B. NLDM DATA BASE STRUCTURE" on page 75. 


NLDM’S USE OF THE CNM INTERFACE 


NLDM, like NPDA, uses the CNM interface to communicate with the SSCP. 
NLDM uses the CNMI: 
¢ to forward requests: 

—- to the access method like: 


START/STOP tracing for a specific resource or resources 
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START/STOP session awareness notification 
GET/FREE tracing buffers 
SEND partial trace buffer 


_ to the NCP to request capture of or to retrieve trace information 
for a session or sessions 


® to receive solicited RUS for NLDM user display: 
NCP trace RUS for SNA and non-SNA devices 
® to receive unsolicited deliver RUs: 


= session awareness RUS generated by the access method whenever a 
session CSSCP-SSCP, SSCP-PU, SSCP-LU, LU-LU, non-SNA 
devices(FID0)) is started successfully or terminated. NLDM col- 
lects the session parameters from the SNA command used to activate 
the session: 


ACRCDRM for the SSCP-SSCP session 
ACTPU for the SSCP-PU session 
ACTLU for the SSCP-LU session 
BIND for the LU-LU session 


= NCP trace RUS generated by NCP each time the session ends for a 
traced SNA resource, and consisting of the sequence numbers of the 
last 4 PIUsS and selected control block fields. Since a session 
does not exist for a non SNA device (FIDO), the NCP will send 
non-SNA trace data when a device error occurs. 


For receiving unsolicited deliver RUs an application must be author- 
ized to use the CNM interface (Cin the APPL statement AUTH=CNM) and 
also be designated in the CNM routing table ISTMGC00 (see "Installa- 
tion" on page 63). The GNM routing table contains the name of the 
application and the type of unsolicited RUs to be received (for NLDM 
RECFMS only). 


NLDM'S USE OF THE NCCF LU - VTAM LU SESSION 


NLDM uses a new NCCF LU task CDSIAMLUT APPL AUTH=CACQ)) to establish a 
session with the secondary ACF/VTAM LU CISTPDCLU) and to receive the PIU 
trace buffers. 


The PIU's are blocked in an access method buffer. The size of the access 
method buffer is an NLDM initialization parameter (BUFSIZE) and is a func- 
tion (see "CHAPTER 6. Performance Considerations™ on page 71) of the maxi- 
mum number of active sessions traced at the same time. The access method 
provides 2 buffers. To increase this number, this value must be changed in 
the replaceable constants module ISTRACON Csee "Installation™ on page 
63), during the tuning process (see "CHAPTER 6. Performance Consider- 
ations" on page 71). 


When the access method buffer is full, its contents are transferred 
through the LU-LU session to the NCCF LU task which sends it to the NLDM 
DST. The number of PIUs kept by NLDM for each session is an initializa- 
tion parameter (CKEEPPIU) and can be dynamically changed by command (see 
"NLDM Commands®™ on page 24). NLDM will request partial buffer data from 
the access method’ when an NLDM operator views PIU data. This ensures that 
any PIU data for the session will be available to the operator. 


NLDM can request the access method to trace PIU's for a named resource or 


all resources. For performance and storage reasons, the access method 
keeps only the first 11 bytes of the RU data. 
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NLDM'S CROSS-DOMAIN SUPPORT 
NLDM cross-domain support requires: 


° an NCCF-NCCF session between the domains (CNCCF START DOMAIN command in 
the requesting domain) 


e an NLDM active in each domain 


In order to achieve this, a list of all CDRM's defined in each domain and 
the corresponding NCCF_id is used by NLDM to collect cross-domain informa- 
tion. The list is coded in the new NLDM member DSIPRMLU of the NCCF param- 
eter library. 


NLDM cross-~domain support allows the user to: 


° view session data for a session partner residing in another domain - 
implicit cross-domain support. NLDM coordinates the routing of 
requests and data between the two domains ("CHAPTER 3. Session 
Tracing™ on page 29). The NCCF_id of the domain from which the data is 
retrieved is displayed. 


© view only session data which resides in another domain - explicit 
cross-domain support. The NLDM Set Domain (CSDOMAIN) command must be 
issued and all the data displayed is now extracted from the new 
domain. To return to the first domain issue the NLDM Set Domain (SDO- 
MAIN) command for this first domain. 


° send NLDM commands from one domain to another - TRACE START/STOP name 
domain_id (see "NLDM Commands" on page 24). 


NLDM FIDO DEVICE SUPPORT 


For FIDO devices NLDM: 

e Will use the device name as the LUNAME 

will receive session awareness unsolicited RU's 

e will receive PIU RU's 

e will receive the NCP data, consisting of the last three P->S FIDO ref- 
erence numbers captured by the NCP and maintained by the access 
method, and the last S->P NCP reference number, in unsolicited trace 
records when a device failure occurs or in aesolicited RU when 
requested for display. 


e the NCP data recorded will be the data existing in storage and corre- 


sponding either to the last device failure or to the last user solic~- 
itation. . | 


DISCARDED PIUS 


A special "pseudo-session” trace buffer area 15 maintained for keeping 
"discarded’ PIU'S and the associated ACF/VTAM module which determined it 
to be discarded. The size of this area is given by an initialization 
parameter (KEEPDISC) and can be displayed and changed dynamically (DIS- 
KEEP and KEEP commands for *DISCARD name). The access method may discard 
a PIU because: 


e the PIU is associated with an active session but it is violating the 
session protocol. These PIU's are also inserted in the session's PIU 
wrap area. 


@ the PIU can not be associated with a session. 
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For a more complete discussion on the DISCARD the reader should refer to 
"Appendix C. VTAM Discard Codes" on page 77 


To display the discarded PIU's enter the command ‘SESS XDISCARD' from any 
display in the hierarchy. 


NLDM.SESS PAGE 
SESSION HISTORY FOR SELECTED NAU 
*¥DISCARD DOMAIN: NCF11 


¥¥**X PRIMARY ****% %**®*® SECONDARY XX 

NAME TYPE DOM NAME TYPE DOM START TIME END TIME 
X¥DISCARD SSCP NCF11 ¥XDISCARD SSCP NCFI1 908/17 14:25:28 **x* ACTIVE ** 
XDISCARD SSCP NCFI11 ¥XDISCARD SSCP NCF11 07722 12:27:37 07722 13:17:3 


END OF DATA 
ENTER SEL# AND PTCP-TRACE), STCS-TRACE), PCSES PARMS), PCCP-CON) OR SCCS-CON) 
1 PT 


Select the number corresponding to a session and the primary 
trace data. 


SPECIFIC SESSION TRACE DATA PAGE 
-------------- +- DOM 


Y SECONDARY 
XDISCARD SA FFFFFFFF EL FFFF NAME *®DISCARD SA FFFFFFFF EL FFFF ! NCF11 


SEQ# DIR TYPE eevee REQ/RESP HEADER XXX RULEN SENS 
0001,ISTTSMRO 81.337 
0000 S-P (+ )RSP rece eG 
OO001,ISTTSMRO 81.337 
0000 S-P (+)RSP --+ OC. 
O0OO0L,ISTTSMRO 81.337 
0000 S-P (-)RSP eo wes 
0001,ISTTSMRO 81.337 
0000 S-P C+ )RSP wee OG, 
0001, ISTTSMRO 81.337 
0000 S-P (+)RSP et oe 
0001,ISTTSMRO 81.337 
0000 S-P (+ )RSP sya Ges 
O001,ISTTSMRO 81.337 
0000 S-P (+)RSP eeeeUGs 


a a oe oe a a a a oe ee a ee a 


ee 
te fe fe et bt ft ee ee et pee Pe et 
wwowovosovwvuvwvowoWNwuowwyW 
oe ee ce ee ae ce ee ee es ee ee ee ce ee 


3) 
4) 
5) 
6) 
7) 
8) | 
9) 
0) 
1) 
2) 
3) 
4) 


TO VIEW MORE DATA 
SEL# OR COMMAND 
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CHAPTER 2. USING NLDM 


INITIALIZATION 


The initialization of NLDM occurs when NCCF is started. NLDM initializa- 
tion consists of building internal tables/control blocks, opening the 
VSAM files and initializing them if they are empty, establishing the LU-LU 
session with the access method, sending a request to activate session 
awareness notification, activating session traces. The last initializa- 
tion date of the current NLDM data base (primary or secondary) appears on 
the NLDM menu display (Figure 3 on page 10). 


The initialization process uses the customer specified initialization 
parameters (see "Data Collection" on page 2 and “Installation"™ on page 63) 
which are: 


e an option to override the access method PIU's trace buffer size - BUF- 
SIZE 


e an option to override the automatic activation of tracing: 
= all sessions with LU resources (SSCP-LU,LU-LU) - TRACELU 
= all SSCP sessions (SSCP-SSCP,SSCP-PU,SSCP-LU) - TRACESC 


e a limit of the resource names for which trace is started or stopped by 
command - MAXTRACE 


e a limit of the number of sessions kept in VSAM file - KEEPSES 
° limits of the virtual storage areas: 

= active session PIU's wrap area - KEEPPIU 

= discarded PIU's wrap area - KEEPDISC 

= outstanding requests on CNMI - MAXSOL 

= buffer and time pending queue size - MAXEND 


For complete and accurate data it is important to initialize the network 
in the following order: 


° start the access method without automatically activating resources to 
be used in sessions that are to be traced by NLDM. For remote 
resources don't activate the NCP Can NCP restart will be required if 
the NCP is activated before NLDM initialization, and you want to have 
NCP trace data available). 


e start NCCF, which includes NLDM activation and automatic tracing of 
all LU, SSCP sessions, necessary for Dynamic Reconfiguration added 
and switched resources 


e using the CLIST capability of NCCF: 
a activate the rest of the network. 


a deactivate the NLDM trace for those resources for which session 
data is not necessary. The session awareness is always captured 
for all sessions that become active after NLDM initialization. 


OPERATION 


To use NLDM, the operator must first log on to NCCF, and then enter the 
NCCF command NLDM, invoking the NLDM command processor. The NLDM command 
provides access to NLDM functions for on-line, interactive viewing of NLDM 
information related to a specific session or sessions. Entering NLDM X on 
a 32793 color display terminal invokes the extended color and highlight 
functions of the terminal for all the NLDM displays. The customer may 
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change the actual NLDM command name specified in the NCCF CMDMDL statement. 
(see "Installation" on page 63). 


Magee of the NLDM or NLDM X command is the display of the message 


NETWORK COMMUNICATIONS CONTROL FACILITY | 08/30/82 16:54:55 A 
* NCF11 NLDM 
NCF11 AAU9S30I NLDM APPLICATION STARTED: PRESS ENTER TO CONTINUE 


After pressing ENTER the NLDM menu is displayed. 


NLDM.MENU 
NETWORK LOGICAL DATA MANAGER MENU 


DOMAIN NCF11 
DESCRIPTION 


LUNAME LIST LIST OF ALL LOGICAL UNIT NAMES 
SLUNAME LIST LIST OF SECONDARY LOGICAL UNIT NAMES 
PLUNAME LIST LIST OF PRIMARY LOGICAL UNIT NAMES 
PUNAME LIST LIST OF PHYSICAL UNIT NAMES 

SSCPNAME LIST LIST OF SSCP NAMES 


HELP EXPLANATION OF COMMANDS 


NLDM FILE LAST INITIALIZED 07716782 


ENTER SEL# OR COMMAND 


Figure 3. MENU DISPLAY 


NLDM runs as a full screen command processor under NCCF, and as such is in 
full control of the terminal. PF-key assignment is as follows: 
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COMMAND PARMS PF/PA KEY DESCRIPTION 


HCELP) PFO01/13 ENTER HELP MODE 
ECND) PFO02/14 END APPLICATION 
RCETURN) PFO3/15 RETURN TO PREVIOUS DISPLAY 
LEVEL 7 
COPY PF04/16 PUT CURRENT SCREEN TO NCCF HARD 
COPY LOG 
TCITLE) PF05/17 GO TO FIRST PAGE IN CURRENT 
DISPLAY LEVEL 
BOTCTOM) PF06/18 GO TO LAST PAGE OF CURRENT 
DISPLAY LEVEL 
BCACK) (N) PFO07/19 MOVE BACK N PAGES IN CURRENT 
| DISPLAY LEVEL 
FCORWARD) (CN) PF08/20 MOVE FORWARD N PAGES IN CURRENT 
DISPLAY LEVEL 
SET HEX ON| OFF PFO09/2] SET HEX DISPLAY MODE 
SESS name PF10/22 DISPLAY SESSION LIST FOR A NAU 
or *DISCARD 
LIST LU|SLU PF11/723 DISPLAY LIST OF NAU NAMES WITH 
PLU|PU|SSCP SESSION DATA 
PF12/24 RETRIEVE LAST COMMAND ENTERED 
PAQ2 ESCAPE TO NCCF MODE 


Figure 4. PF KEY ASSIGNEMENT 


Any text entered in the NLDM command entry line before pressing a PF key 
is used as the operand of the command invoked. 


The RETRIEVE function will display the last NLDM command that was 
executed. Repeated use of this function via PF12 results in the next pre- 
vious command being displayed up to a maximum of twelve previous commands. 


The PA2 key suspends NLDM operator functions and NCCF regains control. 
This allows the user to start another NCCF application (Ce.g. NPDA), to 
execute a CLIST, to establish a session through TAF with a remote subsys- 
tem etc.. Reentering the NLDM or NLDM X command resumes processing from 
the point of interruption: 


NETWORK COMMUNICATIONS CONTROL FACILITY 08/30/82 17:35:38 A 
* NCF11 NLDM 
NCF11 AAU9SOI NLDM APPLICATION RESUMED: PRESS ENTER TO CONTINUE 


2722 KKRX 


In summary, NLDM operator functions are: 


e started - if it is the first NLDM or NLDM X command or if NLDM operator 
functions were previously stopped by the END command 


e resumed - if NLDM operator functions were previously stopped by the 
PA2 key 


During the NLDM operation, any messages sent to the terminal from NCCF, 
the access method, or another NCCF operator are queued, and are displayed 
only after using ENTER, CLEAR, PAl1, or a PF key. ALL messages are dis-~- 
played and NLDM is resumed, after pressing the ENTER key, from the point 
of interruption. 
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HIERARCHY OF NLDM DISPLAYS 
The general layout of the NLDM displays is represented in Figure 5 where: 
NLDM. level of hierarchy PAGE nnn 


title of diplay 
; DOMAIN: xxxxx 


heading and data 


V 
message line 
ENTER nldm prompt OR COMMAND 


Figure 5. NLDM DISPLAY LAYOUT 


e the level of hierarchy is an indication of the display position in the 
hierarchy 


e the xxxxx is the current NCCF domain identification, the domain for 
which session data is displayed or session commands are issued 


° the line reserved for messages may contain: 
—- an error message 
= one of the prompt messages 
ENTER TO VIEW MORE DATA 
END OF DATA 
indicating that there are several numbered pages or there are no 
more pages of data to be viewed (see display control commands in 


"NLDM Commands™ on page 24). 


° the cursor is positioned just under the prompting line, ready to enter 
the NLDM prompt: 


_ sel# - a number that allows the operator to proceed further in the 
display hierarchy 


= R ~ to return to the previous level display 


or any NLDM command or only the operands of a command entered by 
pressing a PF key. 


The NLDM functions are presented to the NLDM operator via a set of hierar- 
chical displays (see Figure 6 on page 13) 


To progress down in the hierarchy use the SEL# or an explicit NLDM command 
which directly invokes a lower level display. 


To return up the hierarchy use the RETURN command CPF3) or an explicit 
NLDM command which directly invokes a higher level display. 
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NLDM| 
MENU ====> 


LIST LU 
LIST SLU 
LIST PLU 
LIST PU 
LIST SSCP|PF11 


SESS name ====> 
|PF10 


SEL #—-PT 


% % 


ACCESS METHOD 
PIU TRACE 


SEL# 


PIU DETAIL 


Figure 6. 


HELP | 


PF] ssox=> 
for command 
description 

SEL# 1 to 5 
DISKEEP PIUS|SESS 
V name ====5 
xX 
NAU NAME K E E P 
LIST counts 
SEL# 
TRACE DISP 
V ===> 
x 
MOST RECENT 
SESSIONS 
SEL#-ST SEL #—P SEL #-PC 
SEL #-SC 


V V 


% X 


V 
% 


CONFIGURATION 
DATA 


SESSION 


NCP TRACE 
DATA PARAMETERS 


HIERARCHY OF NLDM DISPLAYS 


* - display available even if the session is not traced 


x¥¥ - a hexadecimal view of the display is available using 
the command SET HEX ON or the PF9 key 


The following pages contain samples of some NLDM displays: 
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NAU NAME list Display 


This display is a list of the required type of NAU (LU,SLU,PLU,PU,SSCP) 
known by NLDM either because they are currently in session and their ses- 
sion has been activated after NLDM initialization, status ACTIVE, or 
DEES ee able to provide history data from the data base, status 


If there is current session awareness as well as history data in the NLDM 
data base, the NAU will appear as both ACTIVE and INACTIVE. 


This display is reached by selecting 2 from the MENU display or directly, 
from any display in the hierarchy, by the command LIST LUJSLU|PLU]PU]SSCP. 
A sample SLU list is shown below: 


NLDM.LIST PAGE 
NAU NAME LIST 
LIST TYPE SLU DOMAIN NCF11 


STATUS STATUS 
H11L370 INACT INACT 
H1IL371 INACT INACT 
H11L372 INACT INACT 
H11L373 INACT INACT 
H11L374 INACT INACT 
H11L375 INACT INACT 
H11L376 INACT INACT 
H11L377 INACT INACT 
H11L378 INACT INACT 
H11L379 INACT INACT 
H11S25C1 INACT INACT 
H11525C5 INACT RDPDIMVS INACT 
H28L371 INACT TAF11F00 INACT 
H28L372 INACT TAF11FO1 INACT 
H28L373 INACT TAFLIFO2 INACT 


STATUS 
ACTIVE 
ACTIVE 
ACTIVE 
ACTIVE 
H11S25C1 ACTIVE 
ISTPDCLU ACTIVE 
NCF11004 ACTIVE 
TAF11F00 ACTIVE 
TIGNPA ACTIVE 
T140A0F5 ACTIVE 
T24NPA ACTIVE 
T24020E1 ACTIVE 
CICS11 INACT 
D003 INACT 
HO1L371  INACT 


ENTER TO VIEW MORE DATA 
ENTER SEL# OR COMMAND 


a ae a ae ae ae oe ae to ae ee a a a a 22 | 
AM NM MM MPP ND ee & rl 
SCWONKNUPWNROWOONArl 
Nat Nad Ned Ned Net ed a er es es Os as Os Os 
i eT a ae a a a a a a ae ee oe ae ae 8 S| 
oR EN ES oD oD DOGG GAG GHOST] 
UI PWN ROO OONIE AUR WIR rm 
Net Ned OS ed es es 8 ee es a a sO 8 OO 
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Figure 7. NAU NAME LIST DISPLAY 
In this display you can see that H11L372 is marked as both "ACTIVE" and 


WINACTIVE™. Item # 6 ISTPDCLU is the access method LU used for the session 
trace data. 
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MOST RECENT sessions Display 


This 1s a list in reverse chronological order of the sessions kept in his- 
tory data and of the currently active sessions, if there is one. This list 
is for a specific NAU. Each entry includes: 


° name and type of each partner 

° domain of each partner Cif a CDRMDEF card was defined see "Installa- 
tion” on page 63) 

e session activation time (time stamped by NLDM) 

e session deactivation time for sessions that have ended or 


X¥*XXFORCEDX*X for sessions for which data has been copied to disk by 
operator command 


The user may select to display: 


e specific session parameters CP) 

e specific session trace data of the primary or secondary partner 
CPT,ST) 

e specific configuration data of the primary or secondary partner 
CPC,SC) 


If the partner is in the same domain but it 1s a remote resource, then the 
contents of the secondary trace ST is the NCP data. This information 15 
available only if the NCP was activated after NLDM initialization or if 
the NCP is restarted. If the resource is not in the current domain (dis- 
played itn the heading lines of the display), NLDM will automatically 
attempt to invoke NCCF cross-domain procedures to retrieve by implicit 
routing the selected information. This will only succeed if: 


e an NCCF-NCCF session has been established from the operator station 
between the NCCFs. 


e the resource is traced in the alternate domain 


By selecting in a NAU name list display the number corresponding to an 
NAU, for which the sessions are to be viewed, or by entering directly from 
any display in the hierarchy the command 'SESS name't, the operator can 
view the session history display. 


For example SESS NI4BF3A produced: 


NLDM.SESS PAGE 
SESSION HISTORY FOR SELECTED NAU 
NI4BF3A DOMAIN: NCF11 


*¥¥** SECONDARY XXX 
TYPE NAME START TIME END TIME 
SSCP NI4BF3SA 07730 08:46:40 *** ACTIVE Xxx 
SSCP NIGBF3A 07729 16:34:34 07730 08:58:00 
9SCP NISBF3A 07/728 19:45:50 *** FORCED xxx 


SSCP NIGBF3A NCF11l 07728 18:59:26 07728 19:44:56 


END OF DATA 
eae SEL# AND PTCP-TRACE), STCS-TRACE), PCSES PARMS), PCCP-CON) OR SCC(S-CON) 


Figure 8. MOST RECENT SESSIONS DISPLAY 
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Access Method PIU trace data Display 

This is a formatted list of PIUsS kept in storage for an active session or 
found on the data base for an inactive session. Each entry is time stamped 
by the access method Cin GMT) and includes: 


e the sequence number (for non-SNA devices this is a one byte reference 
number ) 


° the direction (P->S,5->P) 
° the type of the PIU: 

_ +RSP,-RSP 

= DATA 


= interpretation of the command (for non-SNA devices an abbrevi- 
ation of the BTU commands ~- see GLOSSARY) 


e the interpretation of the bit settings in the RH (see GLOSSARY) 
° the RU length 
° the SNA sense code for any negative response 
° an indication '"D’' for DISCARDED PIU's 
If the message 

AAU925I NO DATA EXISTS FOR COMMAND SPECIFIED 
is displayed in the message line it means that the PIU trace for this ses- 
sion has not been started. An entry exists for this session in the most 
recent sessions display, because the session was activated after NLDM 
initialization and session awareness is always kept for the sessions that 


are activated after NLDM initialization. 


Select in the most recent sessions display, the number corresponding to a 
session for which the primary partner data is to be viewed. 


As example, "1 PT” from Figure 8 on page 15 results in: 


NLDM.PIUT SPECIFIC SESSION TRACE DATA 
-------------- $---------- SECONDARY --------------+- 
SA 0000000B EL 0001 | NAME N14BF3A SA 0000000E EL 0000 | 


END OF DATA 
ENTER SEL# OR COMMAND 


The corresponding hexadecimal display (PF9 key) contains an unformatted 
hexadecimal list of the same PIU's -TH,RH and a few bytes from the RU. To 
view the eleven bytes of the RU display the PIU detail display. 
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~-PIUT.HEX SPECIFIC SESSION TRACE DATA 
Y -------------- $---------- 


PRIMAR SECONDARY 
SA 0000000B EL 0001 | NAME N14BF3A SA OOOOOOOE EL 


IE HE IE HE HE DE DE HE DE HE DE DE HE IE EE HEE EEE IEEE TH 3K 9 DE KK 9G EE DE DEE EE HEE EEE EE HE X¥N RU *¥X T 
400010122000025A0000000B0000000E1C000001000000420045 0103811CAC 
400010122000825B0000000B0000000E1C000001000000430041 0103811029 
400010122000025C0000000B0000000E1C000001 
G0001012200002Z5D0000000B0000000E1C000001 
400010122000825E0000000B0000000E1C000001 


000000440041 0103811C2B 
000000450041 0103811C27 
000000460041 O0B0000 0103811029 


END OF DATA 
ENTER SEL# OR COMMAND 


Figure 9. ACCESS METHOD PIU TRACE DATA DISPLAY 
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PIU detail Display 


This display is a presentation in hexadecimal of the RU's bytes kept. For 
negative responses, a text definition of the SENSE CATEGORY and of the 
combination SENSE CATEGORY/MODIFIER is also provided. 


Select in the access method PIU trace display the number corresponding to 
a PIU for which all the RU's bytes are to be viewed. A sample follows: 


NLDM.PIUD SPECIFIC RU DETAIL DATA | PAGE 
: NDARY -------------- +- DOM 
SA 0000002D EL 0000 | NCF11 


RU DATA: 10030000410304 
SENSE DATA: 
CATEGORY REQUEST ERROR 
MODIFIER FUNCTION NOT SUPPORTED: THE FUNCTION MAY HAVE BEEN 
SPECIFIED BY A FORMATTED REQUEST CODE, A FIELD IN AN 
RU, OR A CONTROL CHARACTER. BYTES 2 AND 3 FOLLOWING THE 
SENSE CODE ARE NOT USED FOR USER-DEFINED DATA; THEY 
CONTAIN SENSE-CODE SPECIFIC INFORMATION. SETTINGS 
ALLOWED ARE: 
0000 FUNCTION REQUESTED IS NOT SUPPORTED. 
6022 THE RESOURCE IDENTIFIED BY THE DESTINATION 
PROGRAM NAME CDPN) IS NOT SUPPORTED. 
6003 THE RESOURCE IDENTIFIED BY THE PRIMARY RESOURCE 
NAME CPRN) IS NOT SUPPORTED. 
CNOTE: CODE CAN BE USED INSTEAD OF SENSE CODE X'0826'.) 


ENTER ‘'R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


Figure 10. PIU DETAIL DISPLAY 
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NCP trace data Display 


This is an unformatted list of the NCP data captured for the selected ses- 
sion. It contains: 


for a SNA device, the most recent 2 outbound and 2 inbound PIU 
sequence numbers, except for SSCP-LU sessions 


e for a non-SNA device, a one byte reference number for the most recent 
3 outbound and 1 inbound PIU 


e the resource type 


e selected fields from control blocks (see GLOSSARY) that relate to the 
resource type: 


= PU Tl - CUB,LKB,LXB,CCB,AXB 
= PU T2 - CUB,LKB,LXB,CCB,AXB 
= PU T4 - PSB,SNP 

= SNA LU - LUB 


= non-SNA devices - DVB,LCB,IOB,CCB,AXB 
The message 
AAU925I NO DATA EXISTS FOR COMMAND SPECIFIED 


means either the trace for the secondary node of this session has not been 
started or the NCP was activated before NLDM initialization. 


This display is obtained by selecting in the most recent sessions display 
the number corresponding to the session for which the secondary partner 
data is to be viewed, together with "ST" for Secondary Trace. An example 
15 shown below: 


SPECIFIC SESSION TRACE DATA 
RIMAR SECONDARY 
SA 0000000B EL 0001 | NAME P140A0F SA OOOOOOOE EL OOAC | NCF11 


SEQNO: O3AA, 0000, 
0 25 30 


5 
0000000000000000008000000000000040000000890000005200000006000001018000 
ODOSD0DDDDNNNS8NDNN0O7ONDDDDDDNDDDDDDDLTES000000000IES 

05 10 15 20 25 


01 10 15 20 25 0 35 
1€02C100000000942F0B8001F0000000000049510800000001F0000002256911C8351D6 
16C691800D000D0OZEDDOSB714000097ACIC2CC28009406FCA00000000000000000004 
84184B6000FF8371C6110003B724 

01 05 10 


O230404000B000B000B0 


END OF DATA 
ENTER "R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


Figure 11. NCP TRACE DATA DISPLAY 
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Session Parameters Display 


There are different versions of this display depending on the type of ses- 
sion: 


* LU - LU 


° SSCP - PU 
° SSCP - LU 
° oSCP ~- SSCP 


To view this data, select in the most recent sessions display the number 
corresponding to the session for which the session parameters are to be 
viewed, together with "P" for session Parameters. 


As sample, an LU-LU session parameters display is shown below: 
NLDM.SPRM | SPECIFIC careckani PARAMETERS 


SECONDARY: ==ssseeeeeeese Pan 
NAME T140A0F5 SA O000000E EL 00B1 


RU BIND TYPE REQ ACT N/A NEGOTIABLE NO TS PROFILE 3 FM PROFILE 3 
D 4 


FM USAGE/PLU ToS reSsor7= = FM USAGEZSLU 
MULTIPLE RU CHAINS ALLOWED | MULTIPLE RU CHAINS ALLOWED 
REQUEST CONTROL MODE IS IMMEDIATE REQUEST CONTROL MODE IS IMMEDIATE 
PRI ASKS FOR DEF OR EXCEPT RESP SEC ASKS FOR EXCEPTION RESPONSE 
COMPRESSION WILL NOT BE USED COMPRESSION WILL NOT BE USED 
PRIMARY MAY SEND EB SECONDARY WILL NOT SEND EB 


FM HEADERS ARE NOT ALLOWED CONTENTION WINNER IS THE SECONDARY 
BRACKETS ARE USED - RESET STATE=BETB HDX-FF RESET STATE: N/A 

BRACKET TERMINATION RULE 1 USED SEC-PRI PACING 1 STAGE, SEND COUNT 0 
ALTERNATE CODE SET WILL NOT BE USED RECEIVE COUNT 0 MAXRU 1024 
SEQ NUMBERS NZA BIS NZA PRI SEC PACING 1 STAGE, SEND COUNT 0 
SEND/RECEIVE MODE IS HALF-DUPLEX FLIP RECEIVE COUNT 0 MAXRU 1536 
RECOVERY RESP IS CONTENTION LOSER LU TYPE: 2 


ENTER TO VIEW MORE DATA 
ENTER 'R' TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


The same data can be viewed in HEX using SET HEX ON command (PF9 key). 


NLDM.SPRM.HEX SPECIFIC eEoree PARAMETERS | 
SECONDARY : 
NAME TI40A0F5 SA OOOOOOOE EL OO0B1 


01 05 10 15 20 25 30 35 
31010303B1903080000087C70000028000000000185020507F000008D5C3C6FIFIFOFO 
F400 


ENTER TO VIEW MORE DATA 
ENTER ‘'R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


ae session parameters displays Cin text and HEX) for an NCP are shown 
elow: 
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NLDM.SPRM SPECIFIC SESSION PARAMETERS PAGE 
CONDARY -------------- +- DOM-- 
SA 0000000E EL 0000 | NCFil 


RU ACTPU TYPE REQ ACT ERP NEGOTIABLE N“ZA TS PROFILE 5 FM PROFILE 5 
FID 4 


SSCP PU TYPE IS 5 SSCP ID: 05000000000B 
CONTROL VECTORCS): 


C09) ACTIVATION REQ/RSP SEQUENCE IDENTIFIER: 160142072FiF8D86 
(OB) PU FUNCTION MANAGEMENT DATA RU USAGE, 

- NETWORK SERVICES LOST SUBAREA IS NOT REQUIRED 

- ADJACENT LINK STATION NETWORK ADDRESS IS SUPPORTED 


ENTER TO VIEW MORE DATA 
ENTER *R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


NLDM.SPRM.HEX SPECIFIC haahcpal PARAMETERS 
PRIMARY SECONDARY 
SA OO000OOB EL 0001 NAME NIS4BF3A SA OOOOQOOCE EL 0000 


05 10 15 20. 
11325505000000000B0908160142072F1F8D860B01C0 


ENTER TO VIEW MORE DATA 
ENTER 'R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 
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Sample session parameters displays for an SSCP-SSCP session follows: 


NLDM.SPRM SPECIFIC SESSION PARAMETERS PAGE 1 
SECONDARY -------------- +- DOM-- 
SA 00000015 EL 0001 | NCF11 


RU ACTCDRM TYPE REQ ACT ERP NEGOTIABLE NVA TS PROFILE 17 FM PROFILE 17 
FID 4 
CONTENTS ID: SSCP PU TYPE IS 5 SSCP ID: 000000000B 


CONTROL VECTORCS): 
(06) CDRM CONTROL VECTOR, 
- NAME PAIR SESSION KEY SUPPORTED - CDINIT SUPPORTED 
- ADDR PAIR SESSION KEY SUPPORTED - CDSESSEND NOT SUPPORTED 
- PARALLEL SESSIONS SUPPORTED 
- URC IN CD SESSION INIT IS SUPPORTED 
- PCID SESSION KEY IS SUPPORTED 
(09) ACTIVATION REQ/RSP SEQUENCE IDENTIFIER: 1601420840AAD3B8 


ENTER TO VIEW MORE DATA 
ENTER ‘R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


NLDM. SPRM. HEX SPECIFIC SESSION PARAMETERS PAGE 1 
SECONDARY -------------- +- DOM-- 
SA 00000015 EL 0001 | NCFi1 


01 05 10 15 20 25 30 
14021111000000000000000005000000000B000603007E8009081601420840AAD3B8 


ENTER TO VIEW MORE DATA 
ENTER 'R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


Figure 12. SESSION PARAMETERS DISPLAY 
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Configuration data Display 


This shows the configuration for the primary or secondary partner of the 
selected session. It contains the address of the selected partner, the 
domain name, the name of the subarea PU Ceither a HOST or NCP) and the 
names of up to three network nodes: 


e for host application - LU 
° for local SNA - CUA,PU,LU 
e for local non-SNA - CUA,LU 


e for remote resources SNA or non-SNA —- LINK,PU,LU 
No information about Intermediate Network Nodes CINN) is provided. 


To view this display select in the most recent sessions display the number 
corresponding to a session for which the primary or secondary configura- 
tion data is to be viewed, together with "PC™ for Primary Configuration or 
"SC" for Secondary Configuration. A sample of a remote SNA secondary con- 
figuration is shown below: 


NLDM. CONF SPECIFIC SESSION CONFIGURATION DATA PAGE 
PRIMARY SECONDARY -------------- +- DOM 
NAME NCF11004 SA 0000000B EL 0077 i NAME T140A0F5 SA 0000000E EL 00B1 | NCF11 


NI4BF3A 


L1i40A0 


P140A0F 


T140A0F5 


ENTER ‘'R*' TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


Figure 13. CONFIGURATION DISPLAY 
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NLDM COMMANDS 


The NLDM commands may be classified as: 


Display control commands: 

° to move between pages within an NLDM display level 
TCITLE) or PFS - to display the first page 
BOT(TOM) or PF6 - to display the last page 
BCACK) njl or PF7 - to display a previous page 
FCORWARD) n{i or PF8 - to display a next page 


y CCOPY) or PF4 - to copy a display on an available hard-copy printer 
or, if none is available, to the NCCF log. 


° SET HEX OFF JON or PF9 - to view the contents of the display in hexade- 
cimal. Valid only for certain displays (Figure 6 on page 13) 


e to move to different displays 


- HCELP) or PFL - to view the HELP display which provides a 
description of some commands CTRACE,LIST,SESS,KEEP,DISKEEP) and a 
list of display control commands with their attached PF keys 


= ECND) or PF2 - to stop the NLDM operator functions and to return 
control to NCCF. Reissuing the NLDM or NLDM X command, operator 
functions start from the beginning, from the MENU display. This 
command also resets the outstanding operator requests 


= MCENU) - to display the menu display, the first display in the 
hierarchy 


- RCETURN) or PF3 - to display the previous hierarchical display if 
the user is in an hierarchical sequence or the MENU display if not 


Utility commands: 


e TRACE STARTISTOP name]JALL <domainid> - to start or stop session trace 
for any valid NAU or for all NAU's in the current domain, or in an 
alternate one if a domainid is specified 


° TRACE DISP - to display a list of NAU's for which the trace has been 
: started or stopped by command. This display also indicate which NCCF 
operator started or stopped the trace. An example follows: 


NLDM.DIST PAGE 1 
DISPLAY TRACE REQUESTS 
DOMAIN: NCF11 


RESOURCE TRACE 
GLOBAL ON | 
NCF11002 OFF OPER1 08/17 14:42:53 


END OF DATA 
ENTER *R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


Figure 14. TRACE DISP COMMAND DISPLAY 
@ DISKEEP PIUS |SESS FOR namel <name2/ALL> - to display the number of 


PIU's or sessions kept for a specific session or for all sessions ofa 
given named resource (may be ¥DISCARD). 
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As a sample, "DISKEEP PIUS FOR NCF110046" produced: 


NLDM.DISK PAGE 1 
DISPLAY KEEP COUNTS 
DOMAIN: NCF1l 


PRI NAME SEC NAME COUNT PRI NAME SEC NAME COUNT 
NCF11004 TI40A0F5 020 NCF21002 NCF11004 020 
VTAM NCF11004 020 


END OF DATA 
ENTER *R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


Figure 15. DISKEEP PIUS COMMAND DISPLAY 
and "DISKEEP SESS T140A0F5" produced: 


NLDM.DISK PAGE 1 
DISPLAY KEEP COUNTS 
DOMAIN: NCF1l 


PRI NAME SEC NAME COUNT PRI NAME SEC NAME COUNT 
NCF11 TI40A0F5 005 NCF11000 TI40A0F5 005 
NCF11001 TIS0A0F5 003 NCF11002 TI40A0F5 003 
NCF11004 TI¢0A0F5 003 NCF20 T1I40A0F5 003 
NCF20002 TI40A0F5 003 NCF20004% TI40A0F5 003 
NCF20007 T1I40A0F5 003 NCF21 TI40A0F5 005 
NCF21003 TIS40A0F5 005 TSO11 TI4Q0A0F5 005 
T$01101 TIS0A0F5 003 T$01102 TIG0A0F5 005 


TS01103 TiS40A0F5 005 TS$01104% TISQ0A0F5 003 
T$01105 TIS0A0F5 005 TS$01106 T140A0F5 003 
TSO21 TIS$0A0F5 003 TSO02101 TI40A0F5 003 
VTAM TI40A0F5 005 


END OF DATA 
ENTER "R*' TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


Figure 16. DISKEEP SESS COMMAND DISPLAY 


KEEPnnn PIUSISESS FOR namel <name2/ALL> - to change the number of 
PIU's or sessions kept for a specific session or for all sessions of a 
given named resource (may be *¥DISCARD). 


The number of sessions kept in the NLDM data base is updated when a 
new entry for the corresponding session 15 created. 


FORCE namel <name2> - to record the session or sessions data to the 
VSAM data base. Namel may be XDISCARD. 


SDCOMAIN) domainid - set domain command to define the NCCF domain from 
which the session data is to be displayed Cexplicit cross-domain sup- 
port). 


Data display commands: 


LIST LUISLU[PLUI[PU|SSCP or PF11 - to list all resources of the speci- 
fied type for which NLDM data is available either because the resource 
is involved tin an active session or because NLDM has historical data 
from previous sessions. SSCP lists only SSCP-SSCP sessions. LU lists 
of PLU and SLU that have an SSCP session in the host. 
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SESS namel or PF1O - to list the most recent sessions for a specific 
NAU (may be XDISCARD) in reverse chronological order. If a session 
currently exists for this NAU it is displayed first. 


RELATED NCCF COMMANDS 


NLDM]NLDM X - to start or resume NLDM operator functions | 


START DOMAIN=domainid - to initiate a cross-domain session with 
another NCCF. 


ROUTE domainid,command ~- to send NCCF commands to another domain 


SWITCH AAUTSKLP PISIT - to allow access to the primary(P), 
secondary(S) or to close(T) access to the current NLDM data base. 
Active NLDM users may experience unpredictable results. This command 
is intended to be used by an authorized NCCF operator for the purpose 
of error recovery, for data base reorganization etc.. 


The sessions which terminate during the switch operation will be lost 
and those which terminate after the switch operation is finished will 
be recorded in the new data base. 

START HCL=hclname,OP="'* - to start a hard copy log on the named termi- 
nal for the current user.This is required if the NLDM operator wants 
to use PF4 to COPY an NLDM display 


STOP HCL=hclname,OP="* - to stop a hard copy log on the named terminal 
for the current user 


some NLDM commands can be entered directly from the NCCF screen using 
the verb NLDM followed by the command and its operands 


— NLDM TRACE START namel|ALL <domainid> 

— NLDM TRACE STOP namelALL <domainid> 

— NLDM KEEP nnn PIUSISESS FOR namel <name2|ALL> 
= NLDM FORCE namel <name2> 

= NLDM END 


All these commands may be included in CLISTS and the messages that they 
generate are displayed in standard NCCF mode. 


The collection of session awareness data may be stopped, if no resource 
has the trace active, by the command NLDM DISABLE. Use of this command 
should be restricted to authorized operators because: | 


tracing can not be restarted until NCCF is closed down 


to restart full session awareness tracing, both NCCF and the network 
must be restarted 


session data collected is invalid because the notifications of ses- 
Sion activation and termination are not received. Only the history 
file can be considered valid 


MESSAGES 


NLDM uses NCCF services to issue messages to the network console. 


The NLDM messages have the following format: 


AAUNNNI message text 


and are sent to the NCCF authorized terminal operator or the NLDM terminal 
user.If the NCCF authorized terminal operator CAUTH ....,MSGRECVR=YES) is 
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not connected the messages destined for him are sent to the system console 
operator. 


Some messages contain the NLDM CSECT name , the location in it where an 
error condition was detected and the NLDM terminal operator identifier. 
All return codes displayed in NLDM messages are in decimal format. 


All NLDM messages are assembled in a separate CSECT CAAUZMDMA) with 30% of 
free space in text areas to facilitate translation into other languages. 


When an internal NLDM logic error occurs or a serious problem is detected, 
NLDM issues a completion code and the presentation services command pro- 
cessor C(PSCP) terminates processing. This code is presented on the ABEND 
dump listing as a user code Uxxxx. 


Error conditions detected by the access method while processing requests 
Will result in SNA sense codes ( e.g.: 


° X'0806' - resource unknown 


° X'0812" - no storage available to PGF ) 


LOSS OF INFORMATION 


There are several possible cases of loss of information in NLDM: 
° loss of the NCCF LU —- ACF/VTAM LU session. NLDM issues the message 
AAUCSS5I ..... LU SESSION WITH AM LOST: PIU TRACING HAS BEEN TERMINATED 


e loss of PIU trace data when all of the PIU trace buffers are full and 
their contents have not been sent to NLDM. When the next PIU arrives 
ACF/VTAM reuses the buffer that contains the earliest PIU data. NLDM 
recognizes when data is lost and issues the message 


AAUD24SI .....- TRACE BUFFER SEQUENCE ERROR nnn DATA BUFFERS LOST 


A solution to this problem is to define multiple buffers of a smaller 
size (see "CHAPTER 6. Performance Considerations” on page 71) 


e loss of session termination notification caused by too small Buffer 
Pending and Time Pending Queues Cinitialization parameter MAXEND) and 
too many sessions deactivating €ae.g. NCP deactivation which provokes 
the deactivation of all remote sessions). The message 
AAUOSI1I ..... NO FREE SLOTS AVAILABLE IN ..... 
or 
AAUOS8SI ....-. MQS FAILURE DETECTED WHILE PROCESSING TPQ 
Will signal this condition. A solution to this problem is to increase 
the MAXEND value and the corresponding DSRBO value. This last parame- 
ter represents the number of preallocated NCCF blocks for processing 
solicited RUs and VSAM requests. If more requests are received than 
blocks preallocated, then the requests are queued. The recommended 
starting value for DSRBO is 10. 


® loss of session data for sessions which terminated during the switch 
operation 


e main storage unavailable 
° auxiliary storage unavailable 


e physical or logical I/0 errors on the VSAM data base 
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CHAPTER 3. SESSION TRACING 


The network configuration diagram (Figure 17) represents two domains, A 
and B with their resources. 


OS/MVS 3.8 
DOMAIN A 


OS/MVS 3.8 
DOMAIN B 


VTAM V2R1 < CTC > VTAM V2R1 
OSCPA SSCPB 


V 
[Locat | 


PULA PULB 
SLULA SLULB 
NCPA NCPB 


SS SS Vv 
Ee a V2 < > 3705 gags V2 
PU U 
Fura ee L785 aggater We | 
| | | | 
V V V V 
| SNA | [non-SNA| | SNA | |non-SNa| 


PURA TERMA PURB TERMB 
SLURA SLURB 


Figure 17. NETWORK CONFIGURATION DIAGRAM 


The following table shows which session trace data is displayed in DOMAIN 
A depending: 


e on the type of session established (single or multi-domain) 

e on the type of resources for which session trace has been started 

NLDM from DOMAIN A collects data for the resources of DOMAIN A. If only 

one end of the session is in DOMAIN A, the NLDM data collected in DOMAIN B 

for the other end can be obtained by the implicit cross-domain support of 

NLDM if: 

° a session NCCFA-NCCFB has been started from DOMAIN A by the command 
START DOMAIN=NCCFB 


° the end point, residing in DOMAIN B, is traced in DOMAIN B as a result 
of an NLDM command : | 


—- entered by the operator of DOMAIN B 
TRACE START name 

= sent by the operator of DOMAIN A 
TRACE START name NCCFB 

or if a global trace was started in DOMAIN B. 
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P = session parameters and PIU data collected in DOMAIN A. 
p = session parameters and PIU data collected in DOMAIN B 


This data is available entering "# PT" in the most recent sessions display 
of the resource. 


S = NCP data and control blocks collected in DOMAIN A Cfor SSCP-LU, 
sessions control blocks only). 


s = NCP data and control blocks collected in DOMAIN B 


This data is available entering "# ST" in the most recent sessions display 
of the resource. 
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CHAPTER 4. NETWORK CONTROL CENTER USE OF NLDM - SCENARIOS 


Typically, many people in an organization are involved with some part of 
the network problem determination process. These people usually have var- 
ving skill levels and job responsibilities. 


1. Level 1: This is the network ‘Help Desk' level. The help desk has the 
critical function of answering the Cnormally telephone) calls from 
end users who have a real or imagined problem with "The Computer'. 


2. Level 2: This is the Network Operator level. The tasks include: 
startup, closedown, monitoring and control of the network and some- 
times of CICS, IMS, or other on-line applications. 


3. Level 3: This is the highest technical level of problem determination, 
and would include the "SNA™ specialists. This organization is often 
called Technical Support. Problems that cannot be solved by Levels 1 
and 2 come to this level. 


The examples given in this document are for illustrative purposes and may 
not be applicable to all environments. They are examples of some types of 
errors where NLDM can be used to help isolate the failing components or 
indicate the incorrect use of system procedures. One of the prime design 
objectives of NLDM was to assist in the isolation of intermittent or tran- 
sient network problems. As it is almost impossible to create a real 
Yintermittent™ problem we have not simulated the solving of such problems. 


We have rather attempted to give some insight as to how some commonly 
encountered problems can be solved by the correct application of NLDM. 


We have also made no attempt at this stage to break down the problem solv- 
ing process into the relevant skill levels as described above. However it 
would be fair to say that they are probably not directly applicable to the 
Helpdesk operators, but would probably be referred to level 2 or level 3 
support as defined earlier. 

The functions provided by NLDM ViR1 are oriented: 


® to the second line problem determination specialist, system program- 
mer or to any user who has SNA expertise. 


e to the IBM software FE 
® and perhaps to HELP-DESK or NETWORK operators 
Providing a continuous trace on an NAU basis, NLDM can help: 


1. in centralized problem determination. NLDM helps to isolate unde- 
tected logical errors more quickly. The detection can be made: 


e at the first occurrence of a problem; NLDM must have been initial- 
ized before activating the network with the trace started for all 
sessions 


e at the subsequent occurrence of ae problem; NLDM can be 
initialized: : 


= before activating the network and the trace started only on 
demand for the required resources 


= after activating the network and the trace started only on 
demand for the required resources. NLDM can collect data only 
for sessions activated or reactivated after its initializa- 
tion. To collect NCP data, the NCP must be restarted 
2. in documenting: 
e the configuration 
e problem history 


os in monitoring network activity 
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CENTRALIZED PROBLEM DETERMINATION 


Problem determination in a network should be an orderly process to locate 
network components that are failing continuously or intermittently. To 
diagnose a problem, in addition to system dumps and abend codes, the cus- 
tomer can use: 
Standard software facilities 
° ACF/VTAM: 

= buffer use trace 

= buffer contents trace 


= I70 trace 


= NCP line trace 
= NCP transmission group trace 
sa storage display 
e TEST: 
ae link level 2 test 
= explicit route test 
a LU connection test 
CNM-tools 
° for hardware/software problem reporting 
= messages from subsystems and the operating system 
= NPDA - stores and analyzes the error reporting records received 
from the network CRECFMS,RECMS) or from the operating system for 
the locally attached devices 


_ LPDA/386X - tests the line, inspects both ends of a link and sends 
the results to NPDA 


= TARA - analyzes 3600 loop counters 


= CNM/CS - sends the 3600 error loop counters when requested and 
alerts when hwW/s5wW error occurs | 
= DPPX,DPPX/PDA 
e for managing the network 


= NCCF - the TP monitor of local and remote networks 
= OCCF - controls local or remote DOS/POWER and OS/JES systems 


= TAF - controls local and remote 1TS0,IMS,CICS,HCF,NPA and other 
VTAM applications 


= HCF - controls the DPPX systems 
= TARA - controls 470073600 systems 


— SOF - execute a list of operating system commands at specific 
events, message or clock time | 


e for informative and administrative work 
= INFO/SYSTEM 


NLDM can replace the standard buffer contents and I/0 trace. 
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Access to the other standard software facilities or CNM-tools can be 
achieved by using the PA2 key. This key suspends NLDM operator functions 
and returns control to NCCF. Reentering NLDM or NLDM X causes NLDM opera- 
tor functions to be resumed from the point of interruption. This allows a 
flip/flop between NLDM operation and any one of the following processes : 


® execute an NCP storage display using the addresses obtained from the 
NCP control blocks displayed by NLDM 


© start a TEST facility 

= link level two test - F NET,LL2,ID=nodename,options 
This will send a SDLC frame from the NCP to the PU or link 
station, which will return the frame if it has been received cor- 
rectly (the node must be deactivated). 

- explicit route test - D NET,ROUTE,DESTSUB= ,TEST=YES,ER= 
This consists of sending a PIU to the destination subarea, and 
every subarea on the way will return a PIU saying that the corre- 
sponding subarea was reached. 

= LU connection test - IBMTEST on a terminal 
Consists of an echo test on the SSCP-LU session. 


° execute NPDA, using the configuration data provided by NLDM: 


= to discover the problems through notifications ‘alerting'" of 
changes in the system and network status 


= to solicit error and statistical data from SNA controllers 
= to gain access to the NPDA most recent events screen which is an 
on-line summary of the latest events involving the end user's ter- 
minal 
= to obtain for each error: 
NPDA's indication of the probable cause of the error; that is, 
what element(s) of the network are likely to be the failing 
components. 


NPDA's ‘Recommended Action't screen; a list of suggested 
actions for resolving the problem. 


e execute a CLIST 


e execute the COPY command, which copies the display on the available 
hardcopy printer or, if none is available, to the NCCF log 


The type of errors which may be detected more quickly with NLDM are the 
following: 


Session activation 


An entry is created in the MOST RECENT SESSIONS display with the status 
¥*¥% ACTIVE *XX and session parameters are collected only if the session 
Was successfully activated. NLDM can not be used to track ACTCDRM, ACTPU 
and ACTLU session activation errors. 

For a PLU-SLU session activation CLOGON process) you can obtain some 
Information from sense codes of the corresponding VTAM-SLU session, and 
from SNA commands of the VTAM-PLU session. 

The following scenarios are an illustration of: 

e USS logon procedure errors 


a unknown USS command - USSMSG=02,sense=1003 
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= invalid LOGON format - USSMSG=03,sense=1005 
= unknown application —- USSMSG=04,sense=0806 
— unknown LOGMODE name - USSMSG=04, sense=0821 


— invalid BIND parameters 
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USS LOGON PROCEDURE ERRORS. 
1. UNKNOWN USS COMMAND - USSNSG MSG=02; SENSE=1003 


The end user at terminal T140A0F8 is unable to LOGON. The network control 
center operator displays the MOST RECENT SESSIONS of the terminal entering 
(from any NLDM display) the command: 


SESS T140A0F8 


NLDM.SESS 
TI40A0F8 


SESSION HISTORY FOR SELECTED NAU 


DOMAIN: NCF11 
¥¥** SECONDARY XXX 


m 


a a a a a a a a a a a a a ae Ot 


ft a pa ae nt 
PWN OW ONDUD WR 


eat Ned Nd Ned Ned Ned Ne Ned Se Ce A Cw Ow OC SE 


Then, he selects the primary trace data of the active VTAM session. 


%XX PRIMARY XXX 
PE 


NAME 
VTAM 
NCF11003 
NCF11 
NCF11001 
VTAM 
NCF11001 
NCF11000 
NCF11001 
NCF11000 
NCF11000 
NCF11000 
T$01104 
T$011 
T$01103 


DOM 
NCF1l 
NCF1l 
NCF11 
NCF11 
NCF11 
NCF1il 
NCF1l 
NCF11 
NCF1l 
NCF1l 
NCF11 
NCFil 
NCF1l 
NCF1l 


TO VIEW MORE DATA 


SEL# AND PTCP-TRACE), 


NLDM.PIUT 


END OF DATA 
ENTER SEL# OR COMMAND 
2 


The VTAM negative response means that the input request was rejected. 
control center operator selects the negative response (second 
PIU) to get the sense code description. 


network 
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NAME 
TIS0A0F8 
T140A0F8 
T140A0F8 
TI40A0F8 
T1I40A0F8 
TI40A0F8 
TI40A0F8 
TI40A0F8 
TI40A0F8 
TI40A0F8 
TI40A0F8 
TI40A0F8 
T140A0F8 
T140A0F8 


STCS-TRACE), 


TYPE DOM 


NCF11 
NCF11 
NCF11 
NCF1l 
NCF11 
NCF1l 
NCF11 
NCF11 
NCF11 
NCF1l 
NCF11 
NCF1l1 
NCF11 
NCF11 


PCSES PARMS), 


START TIME 


09/15 
09/715 
09715 
09/14 
09/14 
09714 


09714 0 


09710 
09710 
09/09 
09/09 
09/08 
09/08 
09708 


SPECIFIC SESSION TRACE DATA 
NDARY 


C+) RSP 


0 


0 
0 
1 
1 
0 
1 
0 
1 
0 
1 
1 
1 


9: 
9 
9 
0 
0 
9 
73 
23 
1: 
7 
v 
9 
9 
9 


END TIME 
XX ACTIVE alte 


09715 
09/715 
09/714 
09/14 
09/714 
09714 
09/10 
09/710 
09709 
09/709 
09708 
09708 
09708 


PCCP-CON) OR SCCS-CON) 
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The 


0 
0 


NCF1l 


3 
4 1003 
86 


NLDM.PIUD SPECIFIC RU DETAIL ce 


RU DATA: 10030000 
SENSE DATA: | | 
CATEGORY - REQUEST ERROR 
MODIFIER - FUNCTION NOT SUPPORTED: THE FUNCTION MAY HAVE BEEN 
SPECIFIED BY A FORMATTED REQUEST CODE, A FIELD IN AN 
RU, OR A CONTROL CHARACTER. BYTES 2 AND 3 FOLLOWING THE 
SENSE CODE ARE NOT USED FOR USER-DEFINED DATA; THEY 
CONTAIN SENSE-CODE SPECIFIC INFORMATION. SETTINGS 
ALLOWED ARE: 
0000 FUNCTION REQUESTED IS NOT SUPPORTED. 
6022 THE RESOURCE IDENTIFIED BY THE DESTINATION 
PROGRAM NAME CDPN) IS NOT SUPPORTED. 
6003 THE RESOURCE IDENTIFIED BY THE PRIMARY RESOURCE 
NAME CPRN) IS NOT SUPPORTED. 
(NOTE: CODE CAN BE USED INSTEAD OF SENSE CODE X'0826'.) 


oo *R' TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


He notes the text definition of the sense CATEGORY/MODIFIER, in this case 
"function requested is not supported’, which is the unknown USS command. 
The network control center operator returns then to the primary trace data 
display and selects the rejected request (first PIU) to get more informa- 
tion about the LOGON format. 


NLDM.PIUD SPECIFIC RU DETAIL DATA 
SECONDARY 
NAME T1I40A0F8 SA OOOO000E EL O00B4 


RU DATA: E7E8E9 


ENTER 'R' TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


He can see the first 11 bytes ? of the LOGON procedure used. The user has 
entered XYZ which was an unknown USS command. 


2 For 3277 displays the RU also contains the screen control characters 
AID,SBA,SF etc.. 
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2. INVALID LOGON FORMAT - USSNSG MSG=03; SENSE=1005 


The network control center operator gets a call from an end user who can 
not LOGON from the terminal T140A0F8. He then displays the MOST RECENT 
SESSIONS of the user's terminal by entering (from any NLDM display) the 
command: 


SESS T140A0F8 


NLDM.SESS 
T1I40A0F8 


SESSION HISTORY FOR SELECTED NAU 


DOMAIN: NCF11 


XXXXK %%HX SECONDARY *X% 
NAME DOM NAME TYPE DOM 
VTAM NCFIL T1I40A0F8 L NCF1l 


END TIME 


m 


09715 


a a a a a a a ao a a a a ae ae?) 


bt ps > fe fe 
PUANH OW O~AIA UA GAN Hr 


Net Net Ned Ned Ned et Sd Ned A Oe Se Le Oe OC SE 


NCF11003 
NCF11 
NCF11001 
VTAM 
NCF11001 


T$01103 


NCF1l 
NCF1l 
NCF11 
NCFI1 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF1l 
NCF11 


T1¢0A0F8 
TIG0A0F8 
T140A0F8 
TI40A0F8 
T1IS0A0F8 
TI40A0F8 
T1IS40A0F8 
T140A0F8 
TI&0A0F8 
T140A0F8 
T1IS0A0F8 
T1S40A0F8 
T140A0F8 


NCF1l1 
NCF1l 
NCF11 
NCF11 
NCF11 
NCF1l 
NCF1l 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 


09/715 
09/15 
09/14 
09/14 


09714 0 


09/14 
09/10 
09710 
09/09 
09/093 
09/08 
09708 
09/08 


*x¥X ACTIVE XX 


09/715 
09715 
09714 
09714 
09/14 
09/714 


10: 


09710 13 


09710 
09/709 
09/09 
09708 
09/708 
09/708 


TO VIEW MORE DATA 
SEL# AND PTCP-TRACE), STCS-TRACE), PCSES PARMS), PCCP-CON) OR SCC(S-CON) 


He selects the primary trace data of the active VTAM session. 


SPECIFIC SESSION TRACE DATA 
SECONDARY - DOM 

SA 0000000B EL 0001 | NAME T140A0F8 SA O0O000000E EL 00B4 | NCF11 

TYPE RRRXXXRXX REQ/RESP HEADER ¥XXXXXXX RULEN SENS T 
DATA a4 OG. 11 
(-) RSP aes 
DATA Sa 
C+) RSP 
C+) RSP 


NLDM.PIUT 


ENTER TO VIEW MORE DATA 
ENTER SEL# OR COMMAND 
2 


The network control center operator notes that the user request was 
rejected by VTAM Cnegative response). To get the sense description he 
selects the negative response PIU. 
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NLDM.PIUD SPECIFIC RU DETAIL DATA 
SECONDARY -------------- OM 
SA 0000000B EL 0001 | NAME T140A0F8 SA 0000000E EL 00B4 | NCF11 


RU DATA: 10050000 


SENSE DATA: | 
CATEGORY - : ) REQUEST ERROR 
- (0 


MODIFIER 


0 
5) PARAMETER ERROR: A PARAMETER MODIFYING A_ CONTROL 


FUNCTION IS. INVALID, OR OUTSIDE THE RANGE ALLOWED BY 


THE RECEIVER. 


ee "R' TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


The text definition of the sense CATEGORY/MODIFIER, in this case 'parame- 
ter error' indicates an invalid LOGON format. To get more information 
about the LOGON format used, the network control center operator returns 
to the primary trace data display and selects the corresponding PIU type 
DATA (first entry). 


NLDM.PIUD SPECIFIC RU DETAIL DATA 
SECONDARY -------------- 
NAME T140A0F8 SA 0000000E EL 00B4 


RU DATA: ESE2ZD6406BC7D4D6C4F2F1 ¥TSO.,GMOD21* 


ENTER "R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


From the first 11 bytes * of the LOGON procedure used, the network control 
ee operator can see where the error was and explain the correct format 
oO e user. 


s For 3277 displays the RU also contains the screen control characters 


AID,SBA,SF etc.. 
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- DOM - 
NCF11 


3. UNKNOWN APPLICATION =- USSMSG MSG=04; SENSE=0806 


The end user complains of not being able to LOGON from T140A0F8. The net- 
work control center operator then displays the MOST RECENT SESSIONS of the 
user's terminal by entering (from any NLDM display) the command: 


SESS TO140A0F8 


NLDM.SESS 
SESSION HISTORY FOR SELECTED NAU 
NAME: T140A0F8 DOMAIN: NCF11 


¥*¥*X*X* PRIMARY ¥¥*¥* SECONDARY XXX 
NAME NAME TYPE DOM START TIME END TIME 
VTAM T140A0F8 LU NCFIi1l 09715 2:54:37 *** ACTIVE x 


m 


PWN H Ow OIA UBWA Eo 
Ne Ned Ned ed ed er OY Oe Ow Oo SEE 


NCF11003 T140A0F8 NCF11 09715 255 09/15 10: 
NCF11 T140A0F8 NCFil 09715 255% 09715 
NCF11001 T140A0F8 NCF11 09714 247: 09/14 
VTAM TIS0A0F8 NCF11 09714 247: 09/714 
NCF11001 TI40A0F8 NCF11 09714 09:45: 09/14 


TI40A0F8 NCF11 09714 746: 09714 08 
T140A0F8 NCF11 09710 746: 09/710 
T1I40A0F8 NCF1i1l 09710 759: 09710 
TI40A0F8 NCF11 09709 234: 09709 
TI40A0F8 NCF11 09709 :1l1: 09709 
T140A0F8 NCF11 09708 46: 09708 
TIS0A0F8 NCF11 09708 746: 09708 
T$01103 TI40A0F8 NCF11 09708 238: 09708 


TO VIEW MORE DATA 
SEL# AND PTCP-TRACE), STCS-TRACE), PCSES PARMS), PCCP-CON) OR SCCS-CON) 


PLN PRP PR PRN PR PR PR PRR PNP 


a 


He selects the primary trace data of the active VTAM session. 


NLDM.PIUT . SPECIFIC SESSION TRACE DATA 
SECONDARY 
NAME T1I40A0F8 SA OOODODO000E EL O00B4 


TYPE 
DATA 
(-)RSP ere 
DATA hae de 
C+) RSP aes 


C+) RSP 


ENTER TO VIEW MORE DATA 
ENTER SEL# OR COMMAND 
2 


The user request was rejected by VTAM. To find the reason the network con- 
trol center operator selects the PIU which correspond to the negative 
response. 
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NLDM.PIUD SPECIFIC RU DETAIL DATA 
----------- PRIMARY -------------- ---------- SECONDARY -------------- - DOM - 
SA 0000000B EL 0001 | NAME T140A0F8 SA 0000000E EL 00B4 | NCF11 


RU DATA: 08060000 = = = = = = Ke eccecceee. 
SENSE DATA: 
CATEGORY - (08) REQUEST REJECT | 
MODIFIER - €06) RESOURCE UNKNOWN: THE REQUEST CONTAINED A NAME OR 
ADDRESS NOT IDENTIFYING A PU, LU, LINK, OR LINK STATION 
KNOWN TO THE RECEIVER. 


ENTER *R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 
R 


From the text definition of the sense CATEGORY/MODIFIER he concludes that 
the user tried to LOGON to an unknown application. To know which one, he 
returns to the primary trace data display and selects the user request PIU 
(first entry). 


NLDM.PIUD SPECIFIC RU DETAIL DATA 
Y SECONDARY -------------- - DOM - 
SA 0000000B EL 0001 | NAME T140A0F8 SA 0000000E EL 00B4 | NCF11 


RU DATA: D3D6C740E7E7E?7 *LOG.XXX... 2 


ENTER *R' TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


The first 11 bytes * of the user request displayed contains the name of 
the unknown application. In this case XXX. 


4 For 3277 displays the RU also contains the screen control characters 
AID,SBA,SF etc.. 
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&. UNKNOWN LOGMODE NAME - USSMSG MSG=04; SENSE=0821 


From the terminal T140A0F8 the end user can not LOGON. The network control 
center operator then displays the MOST RECENT SESSIONS of the terminal by 
entering Cfrom any NLDM NLDM display) the command: 


SESS T1I40A0F8 


NLDM.SESS 
NAME: T140A0F8 


SESSION HISTORY FOR SELECTED NAU 
DOMAIN: NCF11 


XXXKXN %*RXX SECONDARY XXX 


ma 


NAME 
VTAM 
NCF11003 
NCF11 
NCF11001 
VTAM 
NCF11001 
NCF11000 
NCF11001 
NCF11000 
NCF11000 
NCF11000 
TS501104 
TSO11 


DOM 
NCF1l 
NCF1l 
NCF1l 
NCF11 
NCF11 
NCF11 
NCF1l 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 


NAME 
TISO0A0F8 
TI40A0F8 
TIS0A0F8 
T140A0F8 
TI40A0F8 
T140A0F8 
T1I40A0F8 
T140A0F8 
TI40A0F8 
TI&0A0F8 
TLI40A0F8 
TIS40A0F8 
TIS0A0F8 


09/15 
09/715 
09/15 
09/14 
09/14 
09/14 
09/14 
09/10 
09/710 
09/09 
09/709 
09/08 
09/08 


END TIME 
*¥¥X ACTIVE *X* 


09/15 
09/715 
09/14 
097/714 
09/14 
09/14 
09/10 
09/10 
09/09 
09/09 
09/08 
09/708 


ot at ap at a a a a a a a a a a 92! 
PWM RH OWOANTAUWU RWI 
Net et st ee A es 8 Os Os ss EE 


bP > fe pn ps 


TS01103 NCF11 T140A0F8 09/08 19:38: 09708 


TO VIEW MORE DATA 
SEL# AND PTCP-TRACE), STCS-TRACE), PCSES PARMS), PCCP-CON) OR SCCS-CON) 


SPECIFIC SESSION TRACE DATA 
SECONDARY 
NAME T140A0F8 SA OO00000E EL 00B4 | NCF11 


C+)RSP 


ENTER TO VIEW MORE DATA 
ENTER SEL# OR COMMAND 
2 


The LOGON request was rejected by VTAM. The network control center opera- 
tor tries to get more information about the cause of error, by selecting 
the PIU with the sense code. 
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NLDM.PIUD SPECIFIC RU DETAIL DATA 
SECONDARY =22=3-=37--<2S= DOM 
SA 0000000B EL 0001 | NAME T140A0F8 SA OOOOOOOE EL 00B4 | NCF11 


RU DATA: 08210000 
SENSE DATA: 
CATEGORY - (€08) REQUEST REJECT 
MODIFIER - (21) INVALID SESSION PARAMETERS: SESSION PARAMETERS WERE NOT 
VALID OR NOT SUPPORTED BY THE HALF-SESSION WHOSE 
ACTIVATION WAS REQUESTED. 


ENTER 'R*’ TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 
R- | 


The text definition of the sense CATEGORY/MODIFIER indicates an invalid 
LOGMODE, which means in this case an unknown LOGMODE. The case of invalid 
BIND session parameters does not give a sense code itn the primary trace 
data display of the VTAM session of the terminal. This case is the subject 
of the next scenario. | 


To know which LOGMODE was used, the network control center operator 
a to the primary trace data display and selects the rejected request 
PIU. 


NLDM.PIUD SPECIFIC RU DETAIL DATA 
SECONDARY - DOM 
SA 0000000B EL 0001 | NAME T140A0F8 SA OO00000E EL O00B4 | NCF11 


RU DATA: D3D6C740ESE2D66BC7D4D6 ¥LOG.TSO,GMOxX 


ENTER 'R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


The first 11 bytes ° of the RU displayed are not always sufficient to see 
all the name of the LOGMODE used. | | 


3 For 3277 lal lat the RU also contains the screen control characters 
AID,SBA,SF etc. 


42 NLDM 


INVALID BIND PARAMETERS CBIND FAILURE) 


In case of LOGON failure from a terminal Cin this case T140A0F8) without 
sense codes in the primary trace data display of the VTAM session of the 
terminal, the network control center operator displays the MOST RECENT 
rd aya of the requested application by entering (from any NLDM display) 
he command: 


SESS T$011 


NLDM.SESS 
SESSION HISTORY FOR SELECTED NAU 
NAME: TS011 DOMAIN: NCF11 


¥X*XXX PRIMARY %¥¥¥H *%¥¥% SECONDARY XX 
NAME TYPE DOM NAME TYPE DOM START TIME END TIME 
VTAM SSCP NCF11 TS011 LU NCF1l1l 09716 2734:39 *** ACTIVE x 
TSO11 L NCF1i1l Hiil375 LU NCFl1 09716 oe 09/16 212: 
T$011 NCF112 H11L373 LU NCF1l1 09716 200: 09/16 
TS011 NCF11 H11L374 LU NCF11l 09716 752: 09/716 
TSO11 NCF11 T24020E1 LU NCF1l1l 09716 50: 09/16 
T$011 NCFI1l H11iL371 LU NCF11l 09716 213: 09/716 
TSO11 NCF11 H11S25C1 LU NCF11 09716 746: 09/16 
T$011 | NCF11 T140A0F8 LU NCF1l1 09716 720: 09/16 
TSO11 NCF11 H11L377 LU NCF11l 09716 748: 09/16 
TSO11 NCF11 H11L379 LU NCF1l1 09716 238: 09/16 
TSO11 NCF11 H11L372 LU NCF11 09716 734: 09/16 
TSO11 NCF1l1 H11L372 LU NCF11 09715 744: 09/715 
TSO11 NCF11 T140A0F8 LU NCF1i 09715 701: 09/715 
T$011 NCF11 T140A0F5 LU NCF1l1 09715 523 09/715 


m 


a a an a a a a a a a a a a ae 
ARWNM RP ODOOAIKNU DWN Oo 
Ne Ned Ned ed ed ee Oe a 8 8 8s Os 


ed od ok oe 


TO VIEW MORE DATA 
SEL# AND PTCP-TRACE), STCS-TRACE), PCSES PARMS), PCCP-CON) OR SCC(S-CON) 


SPECIFIC SESSION TRACE DATA 
PRIMARY : SECONDARY DOM 
SA 0000000B EL 0001 | NAME TSO11 SA 0000000B EL 0006 | NCF11 


FMH. 

FMH. 

FMH. 
INITOTHR FMH. 
C+)RSP FMH. 
SESSEND FMH. 
CINIT FMH. 
C+)RSP FMH. 
BINDF FMH. 
CINIT FMH.OC. 
C+) RSP FMH.OC.DR 


itt if tf tt 
VUSHVVIHVMH VY 


i ae a ae ee ae a 


fad pant 
mM OOO ~AI A UIE GIA fe 
Ne ee ew ew Ce SW CY A ee OW 


OUVHM VN DVNOMNM 
I 


ENTER+TO VIEW MORE DATA 
ENTER+SEL# OR COMMAND 
9 


He tries to find the corresponding BINDF PIU and notes the time. In the 
sample this occured at 16.15.35. Selecting the BINDF PIU the network con- 
trol center operator can see in the first 11 bytes displayed the sense 
code of invalid session parameters. 
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NLDM.PIUD SPECIFIC RU DETAIL DATA ee 


CONDARY 
SA 0000000B EL 0006 | NCF11 


8106850821000010071606 


RU DATA: 


V 
sense code of invalid session parameters 


ENTER+'R' TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 
SESS T140A0F8 


To know which LOGMODE was used, the network control center operator dis- 
plays the MOST RECENT SESSIONS of the terminal by entering (from any NLDM 
display) the command: 


SESS T140A0F8 


NLDM.SESS 
T140A0F8 


XXX PRIMARY XXX 
NAME DOM 


SESSION HISTORY FOR SELECTED NAU | 
DOMAIN: NCF11 


¥¥XX SECONDARY XXX 
NAME 


TYPE DOM START TIME END TIME 


m 


He selects the primary trace data of the active VTAM session. 
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S 
C 
( 
( 
C 
C 
C 
C 
C 
C 
C 
( 
( 
C 


ed 


PWN HOW OONA UID WIR oo 


Nat Ned Ne a Na ee A Oe A ew A Oe SE 


VTAM 
NCF11003 
NCF11 
NCF11001 
VTAM 
NCF11001 
NCF11000 
NCF11001 
NCF11000 
NCF11000 
NCF11000 
TS01104 
TSO11 
T$01103 


NCF1il 
NCF11 
NCF1l 
NCF11 
NCF11 
NCF1l 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF1il 
NCF11 
NCF11 


TO VIEW MORE DATA 


SEL# AND PTCP-TRACE), 


NLDM 


T140A0F8 
T140A0F8 
T140A0F8 
T140A0F8 
T140A0F8 
T140A0F8 
T140A0F8 
T140A0F8 
T140A0F8 
T140A0F8 
T140A0F8 
T140A0F8 
T140A0F8 
T140A0F8 


STCS-TRACE), 


NCF11 
NCF1l1 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF1l1 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 


PCSES 


09715 
09715 
09715 
09/14 
09/14 
09/14 
09/14 
09710 
09/10 
09709 
09/09 
09708 
09708 
09/08 


e 
td 


¥¥* ACTIVE *X 
:15: 


09715 
09715 
09/714 
09/714 
09/14 
09/14 
09/10 
09/10 
09709 
09/709 
09/708 
09708 
09708 


PARMS), PCCP-CON) OR SCCS-CON) 


NLDM.PIUT SPECIFIC SESSION TRACE DATA 


Se ee ae PRIMARY: S&S eeceeer ease (See ee r= SECONDARY SS—Sseesre==— = DOM. = 
NAME VTAM SA 0000000B EL 0001 | NAME T140A0F8 SA OO000000E EL 00B4 | NCFil 
SEL # GMT SEQ# DIR TYPE XXXXXXXX REQ/RESP HEADER **XX*®X*XxX% RULEN SENS T 
C 1) 16:15:05 0737 P-S ACTLU gore ce Wl Cre D Ieene-at ene ty eee Ge a) ober ere ee eee 

C 2) 16:15:05 0737 S-P C+)RSP sig Savi GS DIR ioe arch le Soa ae oe. 6, Selene. e a eee Se 16 

C 3) 16:15:05 0000 S-P NOTIFY ey Le ia. © | Glee 2 areca crear anata eater rare aerate as 11 

€ 4) 16:15:11 0001 P-S DATA st ORS DR ara Mees WAS Oe See a eae ee 705 

C 5) 16:15:15 0001 S-P (+)RSP sc A Ne SIN 1h Gos soyane te Guaceh ein Wo sees wes a 0 

€ 6) 16:15:15 0001 S-P C+)RSP al | ar) 0 eee are ee re are ar re ee ee ae oe 0 

C 7) 16:15:15 0001 S-P C+)RSP Siete 1 Oe DIR Oil Seisinere: @ We oie Sow cat) ny Sr ea 0 

C 8) 16:15:18 0000 P-S (€+)RSP PMC OC & DRie %& ooo eel ete yo eee eee Sve 3 

C 9) 16:15:29 0000 S-P DATA srrer oC UD Reese 45566 Si Stee ee oe ae ere ase 1] 

C10) 16:15:32 0000 P-S C+)RSP 4 OG oD Red coor ins ore sco Boe ie Saree ee 0 

C11) 16:15:32 0002 P-S DATA eae UC CDR ¢ wierd ss se Gee wie Eo ei ee 41 

C12) 16:15:32 0002 S-P (+)RSP to OG DR ore: itary ae arene 0S; bee gue sewrelenees 0 


ENTER TO VIEW MORE DATA 
ENTER SEL# OR COMMAND 
9 


He selects the PIU type DATA sent by the terminal, just before the 
noted time of 16.15.35. In this case the PIU type DATA from 16.15.29. 


NLDM.PIUD SPECIFIC RU DETAIL DATA 
SECONDARY 
NAME T140A0F8 SA OOOOO0O00E EL 0O0B4 | NCF11 


RU DATA: D3D6C740 ES EZDEEBE2ZCIE2 *LOG.TSO,SCS*X 


ENTER *R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


The first 11 bytes © of the LOGON procedure used may contain the first 
characters of the LOGMODE used. 


6 For 3277 displays the RU also contains the screen control characters 


AID,SBA,SF etc.. 
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Hung session 


The end user complains that he is not able to enter anything at his termi- 
nal. The network control center operator problem determination process 
using NLDM is described in the following flow chart. 


SESS termname 


V 
select PT data 
of the session 


Capplication 
—- terminal) 


V 
: no investigate 
response from| Yes primary trace 
primary end > data of 
VTAM-PLU session 


V 
no is the investigate 
response from| Yes |secondary end Yes primary trace 
secondary > an applic. data of 
“| VTAM-SLU session 


V V 
ERRONEOUS DATA select second. 
trace data 


is the 
data seq# in 
OUT flow 


outstanding 


ST of the 
session 


pacing 
response 


V 
there is 
a response in 
the IN flow 
for data 


No 


YES V 
>| NCP problem | 


Vv 
either RESOURCE STATUS ERROR CVTAM-SLU session) 
or TERMINAL NOT RESPONDING 


The following scenario is an illustration of a 'terminal not responding’. 
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The network control center operator displays the MOST RECENT SESSIONS of 
the terminal by entering Cfrom any NLDM display) the command: 


SESS T140A0F8 


NLDM.SESS 
SESSION HISTORY FOR SELECTED NAU 
NAME: T140A0F8 DOMAIN: NCF1l1 


HXMNN PRIMARY *XX¥% %¥X¥ SECONDARY XX 
NAME DOM NAME TYPE DOM START TIME END TIME 
NCF11002 NCF11 T140A0F8 LU NCF11 09719 16:11:32 *** ACTIVE xx 
VTAM NCF11 T140A0F8 NCF11 09719 2:09:10 *xx* ACTIVE xx 
NCF11 NCF11 T140A0F8 NCF11 09719 2:11:27 09719 11: 
NCF11002 NCF11 T1i40QA0F8 NCF1l1 09719 2:59:29 09719 
NCF11 NCF11 T140A0F8 NCF11 09719 259:24 09719 
NCF11002 NCF11 T140A0F8 NCF11l 09719 2:35:07 09719 
NCF11 NCF11 T140A0F8 NCF11l 09719 235:00 09719 
VTAM NCF11 T140A0F8 NCF11l 09719 234:23 09719 
NCF11001 NCF11 T1i40A0F8 NCF11l 09/17 2:03:16 09717 
TS01104 NCF11 T140A0F8 NCF11 09/716 7:57:08 09716 
TSO11 NCF11l T140A0F8 NCF11 09716 19:57:04 09/16 
VTAM NCF11 T140A0F8& NCF11l 09716 755:38 09/16 
T$01104 NCF11 T140A0F8& NCF11l 09/716 744:33 09/16 
TSO11 NCF1l1 T140A0F8 NCF1l1 09716 2>44:30 09716 


TO VIEW MORE DATA 
SEL# AND PTCP-TRACE), STCS-TRACE), PCSES 


m 


a a ae ae tt a ae a a a a a a a a S| 
WAN FH ODO OrNIAUD WN eS 


C 
( 
C 
C 
( 
¢ 
( 
C 
C 
C 


1 

1 
EN 
EN 
R 


Ned Ned Ned Ned Ned ew A ed ew 


OF DATA 
ER SEL# OR COMMAND 


Observing a lack of response from the terminal, he notes the sequence num- 
ber of the last PIU which requested a definite response. In this example 
1C. He also notes the sequence numbers of the last two PIUs sent in each 
direction, SLU --> PLU and PLU --> SLU. In this case : 


SLU --> PLU CNCP IN flow) PLU --> SLU CNCP OUT flow) 
1 C 


rlA 1B, 


Then, he returns to the MOST RECENT SESSIONS display to select NCP data 
for the same session. 
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NLDM.SESS 


NAME: T140A0F8 


m 


PPR PR PR PR PRR PRR RRA 


ee 


He selects secondary trace data of the hung session. 


NLDM.NCPT 


LUB: 


PWM HOw OO~AA UID GAH rm 
Net Nad Nd ed ed ed er ee ee Se te ee Se SC SEE 


HHH HK 
DOM 
NCF1il 
NCF1l 
NCF1il 
NCF1l 
NCF11 
NCF11 
NCF11 
NCF1l 
NCF1i1 
NCF1l 
NCF11 
NCF11 


¥**%X PRIMARY 
NAME TYPE 
NCF11002 LU 
VTAM SSCP 
NCF11 LU 
NCF11002 LU 
NCF11 LU 
NCF11002 LU 
NCF1il LU 
VTAM SSCP 
NCF11001 LU 
TS$01104 LU 
TSOL1l LU 
VTAM SSCP 
T$01104 LU NCF1il 
TSO11 LU NCF11 


TO VIEW MORE DATA 
SEL# AND PT(P-TRACE), 


*¥** SECONDARY *xXxXx 


NAME 
T140A0F8 
TI40A0F8 
TI40A0F8 
TI40A0F8 
TIS40A0F8 
TI40A0F8 
TI40A0F8 
T1L40A0F8 
T140A0F8 
TIG0A0F8 
TI40A0F8 
T140A0F8 
TIS0A0F8 
T1I40A0F8 


TYPE 


STCS-TRACE), 


DOM 
NCF1l 
NCF11 
NCF1l 
NCF1l1 
NCFll 
NCF1l 
NCF11 
NCFil 
NCF11 
NCF11 
NCFil 
NCF1l 
NCF11 
NCF1l 


PCSES 


SESSION HISTORY FOR SELECTED NAU 


09/19 
09/719 
09/719 
09/719 
09/19 
09719 
09/19 


09719 1 


09/17 
09/16 
09/16 
09/716 
09/16 
09/16 


PARMS), 


SPECIFIC SESSION TRACE DATA 
SECONDARY 
NAME T1I40A0F8 SA OOOOOOOE EL O0B4 | 


001C, 
25 


DOMAIN: NCF11 


END TIME 
x*¥% ACTIVE Xx 
XxX ACTIVE XXX 
09/19 : 
09/19 
09/19 
09/19 
09/19 
09/19 
09/17 
09/16 
09/16 
09716 
09716 
09/16 


PCCP-CON) OR SCCS-CON) 


DOM 
NCF11 
001B, 001A, 0019 

30 35 


01 05 10 5 2 
0.000000000000000008000001CB400000E000000000000000080000016750090058020 
00000000000900020000000000000000000000000000000000 


END OF DATA 


ENTER 


’R! 


TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


The network control center operator notes that the latest seq# OUT is 1C | 
and the latest seq# IN is 1A. There is no response from the terminal with 
The conclusion is that the terminal has not 


the SEQ# 1C in the IN flow. 
responded to the output message with sequence number IC. 
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NLDM 


Resource status error 

A resource status error is always indicated by a corresponding sense code 
in the primary trace data of the current VTAM session of the terminal. 

To detect this kind of error the network control center operator: 

e displays the MOST RECENT SESSIONS of the supposed failing resource 

e selects the primary trace data for the current VTAM session 

e pages through the primary trace data displays until the latest PIU's 

° selects the PIU with the sense code to get the sense code description 


The following scenarios are an illustration of intervention required and 
LU disconnect error on the terminal T140A0F8 


INTERVENTION REQUIRED ERROR. 


The network control center operator displays the MOST RECENT SESSIONS of 
the terminal by entering (from any NLDM display) the command: 


SESS T140A0F8 


NLDM.SESS 
SESSION HISTORY FOR SELECTED NAU 


S 
¢ 
C 
C 
C 
C 
( 
C 
C 
C 
C 
( 
C 


He selects the primary trace data of the active VTAM session, 


m1 


> ee pe ee pe 


PUN HOO O~NIADUIDWNR lo 


Nt Nad ed et Wd dO ed ed es ee ed ee er SE 


T1S40A0F8 


XXX PRIMARY 
NAME TYPE 

NCF11003 LU 

VTAM 

VTAM 

NCF11003 

NCFil 

VTAM 

NCF11003 LU 

NCF1l 

VTAM 

NCF11004 

NCF11004 

NCF11000 

NCF11000 

NCF11000 


TO VIEW MORE DATA 
SEL# AND PTCP-TRACE), 


¥*¥*¥* SECONDARY **XxX 


NAME 
T140A0F8 
T140A0F8 
T140A0F8 
T140A0F8 
TIG0A0F8 
TI40A0F8 
TIG0A0F8 
TI40A0F8 
TIS40A0F8 
T140A0F8 
TIS0A0F8 
T140A0F8 
TI40A0F8 
T140A0F8 


STCS-TRACE), 


TYPE DOM 


NCF11 
NCF11 
NCF1il 
NCFl1 
NCF11 
NCF1l 
NCFll 
NCF11 
NCF11 
NCF11 
NCF1l 
NCF1l 
NCF11 
NCF11 


PCSES 


START TIME 


09/15 
09/715 
09/15 
09/715 
09/15 
09/715 
09/15 
09/15 
09715 
09715 
09715 
09715 
09/715 
09715 


PARMS), 


7 
e 


DOMAIN: NCF11 


END TIME 


*¥*X* ACTIVE 3% | 


X¥¥* ACTIVE *X* 
09/15 43: 

09/15 
09/15 
09715 
09/15 
09/715 
09/15 
09715 
09/15 
09/15 
09/15 
09/15 


PCCP-CON) OR SCCS-CON) 
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SPECIFIC SESSION TRACE DATA 


TYPE 
ACTLU 
C+) RSP 
NOTIFY 
DATA 
(+)RSP 
(-) RSP 
SESSEND 


20 
:] 
21 
31 
31 
3:1 
2 


END OF DATA 
ae SEL# OR COMMAND 


and from it the PIU with sense code. 


NLDM.PIUD SPECIFIC RU DETAIL DATA 
SECONDARY ~------------- - DOM - 
SA 0000000B EL 0001 | NAME T140A0F8 SA 0000000E EL 00B4 | NCF11 


RU DATA: 08020000 
SENSE DATA: 
CATEGORY - (€08) REQUEST REJECT 
MODIFIER ~- (02) INTERVENTION REQUIRED: FORMS OR CARDS ARE REQUIRED AT 
AN OUTPUT DEVICE, OR A DEVICE IS TEMPORARILY IN LOCAL 
MODE, OR OTHER CONDITIONS REQUIRE INTERVENTION. 


ENTER *R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


The text definition of the sense CATEGORY/MODIFIER indicates the type of 
error, in this case intervention required provoked by the test key. 
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LU DISCONNECT ERROR. 
The network control center operator displays the MOST RECENT SESSIONS of 


the terminal by entering (from any NLDM display) the command: 
SESS T140A0F8 


NLDM.SESS 
NAME: T1I40A0F8 


SESSION HISTORY FOR SELECTED NAU 
DOMAIN: NCF11 


¥*¥*XX PRIMARY **%X% %*%% SECONDARY XXX 


m 


NAME 
NCF11004 


NCF11004 
VTAM 
NCF11000 
NCF11000 
NCF11000 
NCF11000 
TS$01104 
TSO011 
NCF11003 
NCF11001 


DOM 
NCF1i1 
NCF11 
NCF11 
NCF1l 
NCF11 
NCF11 
NCF11 
NCFIl 
NCF1l 
NCF1l 
NCF1l 
NCF1l 
NCF11 


NAME 
TIS0A0F8 
TI40A0F8 
TIS0A0F8 
T1I40A0F8 
TIS0A0F8 
TIS0A0F8 
TISG0A0F8 
TIS40A0F8 
TI40A0F8 
TIiS0A0F8 
TIS0A0F8 
TIS0A0F8 
TIS0A0F8 


TYPE DOM 


NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF1] 
NCF11 
NCF1l 
NCF11 


START TIME 
2:05:35 


09715 
09/715 
09715 
09/15 


09715 1 


09/15 
09/15 
09/715 
09/715 
09/715 
09/15 
09715 
09714 


END TIME 
*¥* ACTIVE xX 
**¥* ACTIVE XX 


09/715 
09/715 
09715 
09/15 
09715 
09715 
09/15 
09/15 
09715 
09/15 
09714 


Fa ae a a a at a a a a a a a a Sf 
bf = fj > f= 

BUNNY OW OAIRUDPWNY Ee 
Ne ed et et ee Ay ey Oe A Or Oe Os Os Oe HE 
CO ke © - = > | f 

Wo uvooqooao & ke 

ee ee ee ee ce ee ee ee e@¢ ee oe 


fan fad fed fed fant fet fen feat 
eooccococeo 
eo ee oe ee oe ee ee ee oe 


09714 


NCF11001 NCF11 T140A0F8 NCF11 09714 


TO VIEW MORE DATA 
SEL# AND PTCP-TRACE), STCS-TRACE), PCSES PARMS), PCCP-CON) OR SCCS-CON) 


SPECIFIC SESSION TRACE DATA 
SECONDARY 
NAME T140A0F8 SA OOOOO00E EL O00B4 


a a a a ae ee ae a ae ee 


mM Ow ONIN UR WN 
et Re ed ew New Cd Se Oe Se OY OL 


C+ RSP 


ENTER TO VIEW MORE DATA 
ENTER SEL# OR COMMAND 
9 


and then, the PIU with sense code to get the sense code description. 
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NLDM.PIUD SPECIFIC RU DETAIL DATA 


----------- PRIMARY -------------- ---------- SECONDARY -------------- - DOM - 
NAME VTAM SA 0000000B EL 0001 | NAME T140A0F8 SA 0000000E EL 00B4 | NCF11 
RU DATA: 08310000 has ooeahaws x 


SENSE DATA: 
CATEGORY - (€08) REQUEST REJECT 
MODIFIER - €31) LU COMPONENT DISCONNECTED: AN LU COMPONENT IS NOT 
AVAILABLE BECAUSE OF POWER OFF OR SOME OTHER 


DISCONNECTING CONDITION. 


ENTER *R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


The text definition of the sense CATEGORY/MODIFIER indicates an LU compo- 
nent disconnect which has been provoked in this case by manipulating the 
security key. 
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Erroneous data 


Erroneous data may be sent by each end point of a session. 


The data may violate the session protocol, and then the corresponding 
entry in the ACCESS METHOD PIU TRACE DATA display 1s noted by an "D" in 
column T and is also kept in the discarded PIU's session. 


The data may request a function which 1s not supported by the other end 
point. 


The following scenarios are an illustration of erroneous data sent by the 
application and by the terminal. 


ERRONEOUS DATA SENT BY THE APPLICATION. 


The end user reports a programming error, message 


PROGxxx 


on the bottom line of the display T140A0F8. The network control center 
operator displays the MOST RECENT SESSIONS display of the terminal by 
entering (Cfrom any NLDM display) the command: 


SESS T140A0F8 


NLDM.SESS 
SESSION HISTORY FOR SELECTED NAU 
T140A0F8 DOMAIN: NCF11 


X*¥*¥*%% PRIMARY X*®¥¥*% **X*® SECONDARY XXX 
NAME TYPE DOM NAME TYPE DOM START TIME END TIME 
NCF11001 LU NCF11 T140A0F8 NCF11 09715 247: ¥¥X ACTIVE XxX 
VTAM SSCP NCF11 T140A0F8 NCF1l1 09715 RX ACTIVE XxX 

NCF1l LU NCF11l T140A0F8 NCF1i 09715 09/15 19:47: 

NCF11001 LU NCF11 T140A0F8 NCF11 09715 09715 
NCF11 LU NCFil T140A0F8 NCF11 09715 09715 
T$01101 LU NCF11 T140A0F8 NCFIll 09715 09/15 
TSOl1 LU NCF11 T140A0F8 NCF1l1 09715 09/15 
NCF11001 LU NCF11 T140A0F8 NCF1I1l 09715 09/15 
NCF1il LU NCF11 T140A0F8 NCF11 09715 09715 
VTAM SSCP NCF11 T140A0F8 NCF11l 09715 09715 
T$01102 LU NCF11 T140A0F8 NCFIl 09715 09/15 
TSO11 LU NCF11 T140A0F8 NCF11 09715 09715 
NCF11001 LU NCF11 T140A0F8 NCF11 09715 09715 
VTAM SSCP NCF1i1l T1i40A0F8 NCF11 09715 09/15 


TO VIEW MORE DATA 
SEL# AND PTCP-TRACE), STCS-TRACE), PCSES PARMS), PCCP-CON) OR SCC(S-CON) 


mr 


PWM HOwWOUNA UO BRBWRe Oo 
Net et ed ee ey A 8 8 Ow 8 Oo SE 
fone feed fed fad fad fend fat fad fut ft fat ft fd 
WwowowvovwvvVvwovwowowowO 

ee ee ee ee ee ee oe ee ee oe ee ee 


S 
C 
( 
C 
C 
C 
C 
C 
C 
C 
C 


fe fat ft ft 
_ 
Xe | 
ee 
fae fad pad fae fad fad fad fad ft ft fe 
WDOODOUDWOWODOVYO 
ee ee ee ee ee es ce oe ee ee e¢ 


He selects the primary trace data of the failing session. 
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SPECIFIC SESSION TRACE DATA 
M SECONDARY DOM 
NCF11001 SA 0000000B EL 0074 | NAME T140A0F8 SA OO000000E EL 00B4 | NCF11 


TYPE 
DATA 
C+) RSP 
DATA 
DATA 
(+)RSP 
DATA 
(+) RSP 
DATA 
DATA 
(-)RSP 
CLEAR 
C+)RSP 
SDT 
C+) RSP 


C 
C 
C 
¢ 
( 
¢ 
( 
C 
C 
( 
( 
C 
¢ 


PUAN H woos A UID Gh 
et Net Ne Nd Yaw Ce ed Ow Oe Ce Se OW OW OS 
OUVSHAH TH VGN VHHVHw 

{ 
VN VN VN VN Vw vD 


fa feat foot fa fae 


ENTER TO VIEW DATA 
ENTER SEL# OR COMMAND 
10 


The data sent by the application as a result of a user request was 
rejected by the terminal. To find out the reason, the network control cen- 
ter operator selects the PIU with sense code. 


NLDM.PIUD SPECIFIC RU DETAIL DATA 
SECONDARY - DOM 
NAME T140A0F8 SA OOQOOOOE EL 00B4 | NCF11 


RU DATA: 10030000 
SENSE DATA: 
CATEGORY - REQUEST ERROR 
MODIFIER - FUNCTION NOT SUPPORTED: THE FUNCTION MAY HAVE BEEN 
SPECIFIED BY A FORMATTED REQUEST CODE, A FIELD IN AN 
RU, OR A CONTROL CHARACTER. BYTES 2 AND 3 FOLLOWING THE 
SENSE CODE ARE NOT USED FOR’ USER-DEFINED DATA; THEY 
CONTAIN SENSE-CODE SPECIFIC INFORMATION. SETTINGS 
ALLOWED ARE: 
0000 FUNCTION REQUESTED IS NOT SUPPORTED. 
6022 THE RESOURCE IDENTIFIED BY THE DESTINATION 
PROGRAM NAME CDPN) IS NOT SUPPORTED. 
6003 THE RESOURCE IDENTIFIED BY THE PRIMARY RESOURCE 
NAME (PRN) IS NOT SUPPORTED. 
CNOTE: CODE CAN BE USED INSTEAD OF SENSE CODE X'0826"'.) 


ENTER ‘'R* TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


From the text definition of the sense CATEGORY/MODIFIER he concludes that 
the user transaction request (SEQ# 6) results in some erroneous data sent 
by the application (CSEQ# 1A and 1B). 
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ERRONEOUS DATA SENT BY THE TERMINAL. 
The end user complains that the keyboard of his terminal is locked. 
The network control center operator then displays the MOST RECENT SESSIONS 


of the terminal, in this case TI40A0F8, by entering (Cfrom any NLDM 
display) the command: 


SESS T140A0F8 


NLDM.SESS 
NAME: T140A0F8 
¥¥¥*X® PRIMARY X**¥*¥*%%  *¥¥* SECONDARY x 


NAME TYPE DOM NAME TYPE DOM 
NCF11001 LU NCF11 T140A0F8 NCF1il 
VTAM 


SESSION HISTORY FOR SELECTED NAU 
DOMAIN: NCF11 


m 


END TIME 


START TIME 
: xXx ACTIVE x 


09/15 
09/15 


SSCP NCF11 T140A0F8 NCF11 
NCF11 TI40A0F8 
TIS0A0F8 
TISOA0F8 
TIS0A0F8 
TISO0A0F8 
TI40A0F8 
T140A0F8 
T1S40A0F8 
T1i40A0F8 
T1I40A0F8 
T1IS0A0F8 


NCF11001 
NCF11l 
T$01101 
TSO11 
NCF11001 
NCF11 
VTAM 
T$01102 
TSO11 
NCF11001 


LU 
LU 
LU 
LU 
LU 
LU 
LU 


SSCP 


LU 
LU 
LU 


NCFil 
NCF11 
NCF11 
NCF11 
NCF1il 
NCF11 
NCF11 
NCFil 
NCFIl 
NCF11 
NCF1l 


NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF1l 
NCF1l 
NCF11 
NCF1l 


09/715 
09/15 
09/15 
09/15 
09/715 
09/15 
09/15 
09/15 
09715 
09715 
09/15 


**X ACTIVE XxX 
253 


09/15 
09/15 
09/15 
09/715 
09715 
09/15 
09/15 
09/15 
09715 
09/15 
09/715 


19: 


PAH Ow Ory UDWN ee 
ee Nee Net Ned Ned ed ed Ad Od Se 8 OY UY CY SE 


a 


PRP LPR LR LRP ERR RNP PRG 
owovovovowsovowowow wo 
ee ee ee ee ee ¢8f eo 0 ee e¢ ee 


fm foe feed fet feed ft fad fad fad fed fd f-3 J? fe 
wowovovovuvwvuvuwuowuvuvwTuws wy 
oe oe ee ee ee ee ee oe ee ee ee o¢ ee 8 


fad fend fad fad fat 


VTAM SSCP NCF11 


TO VIEW MORE DATA 
SEL# AND PTCP-TRACE), STCS-TRACE), PCSES PARMS), PCCP-CON) OR SCCS-CON) 


T140A0F8 NCFil 09/715 09/715 


TYPE 
DATA sass 
(-)RSP 
DATA 
C+)RSP 
C+ RSP 


ENTER TO VIEW MORE DATA 
ENTER SEL# OR COMMAND 
2 
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The data sent by the user was rejected by VTAM. To get the description of 
the sense code the network control center operator selects the negative 
response PIU. 


NLDM.PIUD SPECIFIC RU DETAIL DATA 
SECONDARY 
NAME T140A0F8 SA O000000E EL 00B4 | NCF11 


RU DATA: 10020000 
SENSE DATA: 
CATEGORY - €10) REQUEST ERROR 
MODIFIER - (€02) RU LENGTH ERROR: THE REQUEST RU WAS TOO LONG OR TOO 
SHORT. 


ENTER 'R*’ TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 
R 


From the text definition of the sense CATEGORY/MODIFIER determines the 
network control center operator decides to return to the primary trace 
data to verify the RU length. In this case the RU was too short, it has a 
length of zero which is probably due to operator error at the terminal. 
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Poor response times 


To detect the cause of poor response times ina session the network con- 
trol center operator: 


° increments the number of PIU's kept for this session. He will thus be 
able to view more exchanged PIUs ; 


° from the MOST RECENT SESSIONS display of the terminal he selects the 
primary trace data of this session 


@ pages through the primary trace data displays and notes the times 
T,t0,t1,t2,....ti12R 
SEL # GMT SEQ# DIR TYPE ¥¥¥*¥*XX REQ/RESP HEADER XX 
C ) T n S-P DATA Pe gr 0 | Oe acl, Cee ery operas BBs é2CD..s. 
a) t0 m P-S DATA deste see wht ee EOIN & ocgracace aiete ooh» Eee ae 
C ) tl mil P-S DATA SIC 5 CE Riv eis woe er Ba eee ee eee 
a) t2 m2 P-S DATA SING 2B ececank 4 io Woes aud cece aoe ees 
(>) ti mi P-S DATA. .... OUD Ri ec er ataeceseanc 
¢ +) R mi S-P € )JRSP BC Rates eee aes Boat Ste echoes 
e compares: 
t0 - T - host system and primary application process time 
ti - (€ti-1) - host system process time 
R =- tj - network plus terminal time 


As an example, see the scenario that follows. 
An end user complains of bad response times at terminal T1I40A0F8. The 


network control center operator displays the MOST RECENT SESSIONS by 
entering Cfrom any NLDM display) the command: 


SESS T140A0F8 


NLDM.SESS 


NAME: T1I40A0F8 


¥*¥XXN PRIMARY XX 


SESSION HISTORY FOR SELECTED NAU 
DOMAIN: NCF11 


XXX SECONDARY XXX 


mr 


S 
( 
( 
C 
( 
( 
( 
( 
( 
C 
( 
( 


bat foo 


MV OW O~AIAU DWN 
Na et ee ey ee we Ow 8 OY Ow fE 


NAME 
T$01104 
VTAM 
NCF11001 
NCF11000 
NCF11001 
NCF11000 
NCF11000 
NCF11000 
T$01104 
T$011 
T$01103 


TYPE DOM 


NCF11 
NCF11 
NCF1l 
NCF1l 
NCF1l 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 


TO VIEW MORE DATA 


SEL# AND PTCP-TRACE), 


NAME 


T140A0F8. 


TISOA0F8 
TIS0A0F8 
TI4G0A0F8 
TIS40A0F8 
TIS40A0F8 
TIS40A0F8 
TIS0A0F8 
T1I40A0F8 
TIS40A0F8 
TL40A0F8 


STCS-TRACE), 


TYPE DOM 


NCF1l 
NCF1l 
NCF1l1 
NCF1l 
NCF11l 
NCF11l 
NCF1l 
NCF11 
NCFil 
NCF11 
NCF11 


PCSES PARMS), 


09/14 
09/14 
09/14 
09714 
09/710 
09/710 
09709 
097/09 
09/08 
09708 
09/08 


END TIME 
¥XX ACTIVE XxX 
XXX ACTIVE xX 


09/14 
09/14 
09/710 
09710 
09/09 
09709 
09/08 
09/08 
09/08 


PCCP-CON) OR SCCS-CON) 


He selects the primary trace data of the session with poor response time. 
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SPECIFIC SESSION TRACE DATA 


TYPE ° 
DATA 
DATA 
DATA 
DATA 
C+)RSP 
DATA 
DATA 
DATA 
DATA 
C+) RSP 


( 
¢ 
C 
C 
C 
C 
C 
C 
C 


OO OOW NID UO DB GH 
Ww 


END OF DATA 
ENTER SEL# OR COMMAND 


The network control center operator notes that the first transaction (SEQ# 
49) takes about 2 minutes of host system and application process time. 
The poor response time is probably caused by the application process 
time,since the multiple output chained message was sent with no apparent 
system delay. Comparing this transaction with the next one, which has a 
good response time he concludes that the first transaction is a heavy one. 

Displaying the detail of the corresponding user request (SEQ# 49) he may 
found out what this transaction was. 
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Session inactivation 


Session inactivation errors are a special case of 'HUNG' sessions. The 
helpdesk operator problem determination process ,using NLDM, is described 
in the following flow chart: 


SESS NAUname 


select primary 
trace data 


of an ACTIVE 
session 


V 
is the investigate 
primary end anj] Yes |trace data for 
application >|/UNBIND command 
and response 


V 
investigate 
trace data for 
SNA commands: 


DACTLU,DACTPU, 
DACTCDRM and 
responses 
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DOCUMENTATION 


The documentation of the configuration or of a problem is implemented 
through INFO/MANAGEMENT. NLDM can provide, by means of the COPY function, 
the knowledge: | 


° of how a component is connected (the name of the subarea PU, and the 
names of up to three network nodes - LINK/CUA,PU,LU) 


e of the environment just before the problem appeared or during a test 


MONITOR NETWORK ACTIVITY 
Keeping a time stamped track of the start and termination time of 
sessions, NLDM can provide useful statistics about: 
° the availability of the system 
e the availability of applications with: 
= the number of sessions 
= the terminals connected 
= the peak period of utilization 
° the availability of a terminal with: 


ee the number of sessions with a given application and the average 
session time 


ee the peak period of utilization 

° the number of discarded PIUs and the associated ACF/VTAM modules. 
This data can be checkpointed using the FORCE command for XDISCARD 
name in conjunction with an NCCF timer driven CLIST 

The method which may be used to obtain these statistics is the VSAM REPRO 


function of the SIR or SID records (see "Appendix B. NLDM DATA BASE STRUC- 
TURE" on page 75) followed by an SLR analysis. 
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CHAPTER 5. INSTALLING NLDM 


NLDM runs on all IBM host processors supported by TCAM/VTAM on OS/VS2 sys- 
tems. 


PROGRAMMING REQUIREMENTS 


NLDM operates with OS/VS2(MVS) Rel 3.8 using: 
e one of the following TP access methods: 
- ACF/TCAM Version 2 Release 4 


_ ACF/VTAM Version 1 Release 3 or ACF/VTAM Version 2 Release 1 each 
one with ACF/VTAM SPE 


° NCCF Release 2 with NCCF SPE 
° VSAM 


ACF/NCP Version 2 1s not a prerequisite for NLDM, but 1s required to 
obtain the NCP PIU sequence numbers and control blocks. 


STORAGE REQUIREMENTS 


No dedicated real storage is necessary. However, the buffers used by VTAM 
for PIU tracing are in fixed common storage area (CSA). 


Virtual storage (Figure 18 on page 62) and disk storage (Figure 19 on page 
62) requirements depend on the number and kinds of sessions traced and the 
amount of session data kept for each session traced. 


Each installation should establish the following values €remember to 
check the NLDM Installation and reference manual): 


° U - number of NLDM users 

S - number of unique session name pairs 
° SA - number of sessions active 

° T - percentage of sessions traced 

° SK - average number of sessions kept 

° PK - average number of PIU kept 


° DSRBT - Sum(NLDM DSRBO, NPDA DSRBO, NPDA DSRBU) values 
e MXE - Maximum number of session_ends in 5 seconds. 
° MXT - Maximum number of explicit trace commands. 


For applications like TSO or NCCF, at each logon the following three ses- 
sions are created: 


<NCCF_idxxx|TSOidxxx> - terminal 
<NCCF_idxxx|TSOidxxx> - VTAM 
<NCCF_id|TSOid> - terminal Cfor the logon/logoff process) 


The virtual storage requirements are summarized in the table below: 
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PROGRAM STORAGE 
display functions 
common display service functions 
data services functions 
CONTROL BLOCKS & TABLES 
presentation services 
30K x U 
common control storage 
10K x DSRBT 
24 »x« MXT/1000 
100 x MXE/1000 
1650 x BUFSIZE/1000 
SA x (€300 + TX €300 + PK x 50))71000 
(BUFNIXIndxCISZ+BUFND*¥DataCI5Z)/1000 


Figure 18. NLDM STORAGE ESTIMATES 


Auxiliary storage requirements are shown below: 


LIBRARIES Ccyl-dir blocks for 3330) 
SYSI.NLDMLIB (3-10) 
SYS1.NLOADLIB (5-50) 

PRIMARY VSAM DATA BASE 

CYL = €2.09 x€S x€150 + SK x(€420 + 


+ T% x€450 + PK x102)))))/BC 
BC = number of bytes per cylinder 
for DASD type 


TOTAL NUMBER OF CYLINDER 


Figure 19. NLDM AUXILIARY STORAGE 


Example: 


For a network composed of Cand viewed from one host): 


resource session name sessions sessions 
pairs active traced 


SSCP—PLU 
Cnone) 


other dom. 


20 SLU in 
same dom. 


10 SLU in 
other dom. 


and for 
U = 3 NLDM users 
T = 100% sessions traced (T=1.0) 
SK = 10 average sessions kept 
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RRRKRRRAR 


PK = 10 average PIU kept 

MXE = 500 maximum session terminations 
MXT = 100 maximum explicit trace commands 
DSRBO = 10 CNLDM) 

DSRBO = 4 CNPDA) 

DSRBU = 1 4(NPDA) 

DSRTU = 15 

BUFSIZE = 32K 


we need 701K of virtual storage. 


PROGRAM STORAGE 
display functions 
common display service functions 
data services functions 
CONTROL BLOCKS & TABLES 
presentation services 
30K x U 
common control storage 
10K x DSRBT 
24 x MXT/1000 
100 x MXE/1000 
1650 x BUFSIZE/1000 
SA x €300 + TX €300 + PK x 50))271000 


This figure does not include the virtual storage requirements for VSAM. 
This will depend on the definitions used for the VSAM datasets. 


The NLDM data base requires 33 cylinders. 


cylinders = €2.09x200x(€150x10x€420t1.00x(450+10x102))))/13030x19 
= agree 
= 33 


INSTALLATION 


The following steps are necessary to install NLDM: 


APPLY APPROPRIATE PTFs ON ACF/VTAM V2R1_ (5665-280,FMID=HVT2101) or on 
ACE/VTAM V1IR3 


Always make reference to the DIRECTORY to obtain a complete list of 
required PTF's. 


APPLY APPROPRIATE PTFs ON NCCF RELEASE 2 (€5752-XX6, FMID=HCS1502) 
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APPLY THE NLDM PROGRAM PRODUCT (5668-971, FMID=HLD1100) 


which results in the creation of two libraries: 


SYS1.NLOADLIB the distribution library 
SYS1.NLDMLIB the processing library 


DEFINE THE NLDM APPLICATION TO NCCE 
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NLDM 


MODIFY THE NCCF DEFINITIONS 


Add the following statements to DSICMD member 


HE HE HE HE HE DE DE DE IE HE DE DE DE DE IE DE DE DE DE DE DE DE DE DE DE DE IE DE DE DE DE DE DE DE DE DE DE DE DE IE DE DE DE DE DE DE IE DE DE FEE DE IE DE DE DE DE DE DE DE DE DE DE DE IE EE DE HE EK 


% 


DSICMD 


member % 


% (change the name of the NLDM command if necessary) ¥ 
HEHEHE DEE DEE HE HEHE DEE IE IE NE IE DE DE DE DE DEE IE IE IE DEE DE DE DE IE DE DE DE DE DE NE DE DE DE DE DE DE DE DEE DE DEE HE DE DE EE EE DEE DE DE DE DE DE DE DE IEE DE DE DEE 


NLDM 


DISABLE 

AAUPCPEX 
AAUDCPEX 
AAUIBMPD 
DSILUITF 
AAUDOSOA 
AAUDO50A 
AAUDO95A 
AAUDOOIA 
AAUDO2Z0A 
AAUDOO2A 
AAUSTPQA 


CMDMDL 


MOD=AAUPNLDM, TYPE=R 


PARMSYN KEEP,K 

PARMSYN TRACE,T 
PARMSYN FORCE,F 
KEYCLASS 1 


CMDMDL 
CMDMDL 
CMDMDL 
CMDMDL 
CMDMDL 
CMDMDL 
CMDMDL 
CMDMDL 
CMDMDL 
CMDMDL 
CMDMDL 


MOD=AAUPCPEX, TYPE=R 
MOD=AAUDCPEX, TYPE=RD 
MOD=AAUPCPEX, TYPE=R 
MOD=DSILUITF,TYPE=D,CTL=N 
MOD=AAUD090A,TYPE=D 
MOD=AAUD050A,TYPE=D 
MOD=AAUDO95A,TYPE=D 
MOD=AAUD001A,TYPE=D 
MOD=AAUD020A,TYPE=D 
MOD=AAUD002A,TYPE=D 
MOD=AAUSTP@QA, TYPE=D 


HE HE HE EE HE HE HE HE HE EE HEE HE EK HE HEE EK EE HE DEE DEE DEE DE DEK DE DE DEK OK DK OE DEK DE HE DE DE DE DE HE DE IE DE IE IE IE IK 3K DE DEK OE OE OE EE KH 


Add the following statements to DSIDMN member 


DE HE HE HE HE DE DE HE IE DE HE DE HE DE HE HE HE IE HE DE HE DE DE DE DE DE DE DE DE HE IE IE DE HEE HE HE IE DE DE HE DE DE IE DE DE HE IE DE DE IE DE HE IE DE DE DE HE EE DE DE NE HE HE HE EE KE KH 


% 


% 


DS IDMN 
HE HE 9 3 HEHE IE DE DE DE EE IE IE DE DE DK DK DE DE DE DE IE BE DK DE DE DE IE DK DK DE DE DE DE DE DE DK DK DE DK DE DE IE DK DE DE DE DE DE DE DK DE DE-DE DE IE DE DK DK DE DK DE DE DE DK OK DE I OE 


member x 


* 1f NPDA is installed 
TASK 


TASK 
TASK 
TASK 


MOD=DSIZDST,TSKID=BNJDSERV, INIT=Y,PRI=6,MEM=NLDMBDST 
MOD=DSIZDST,TSKID=AAUTSKLP, INIT=Y,PRI=7,MEM=AAUPRMLP 
MOD=DSIZDST,TSKID=DSTAMLUT, INIT=Y,PRI=7,MEM=DSIPRMLU 
MOD=AAUNTIMR, TSKID=AAUNTIMR, INIT=Y,PRI=9 


¥ 
* if NPDA is not installed 


TASK 


TASK 


TASK 


MOD=DSIZDST, TSKID=AAUTSKLP, INIT=Y,PRI=6,MEM=AAUPRMLP 
MOD=DSIZDST, TSKID=DSIAMLUT, INIT=Y,PRI=7,MEM=DSIPRMLU 
MOD=AAUNTIMR, TSKID=AAUNTIMR, INIT=Y,PRI=9 


DE HE HE HE DE HK HE DE HE KE DE HE HE HE DE HE HE HE DE HE KK DE EE HE DE HE DE DEK IE IE EE IE EK DE DE IE EK EK DE HE HE EK EE HE EK EK KK HEE HK EH HK HK 


Add the folloning member to DSIPARM library if NPDA is installed 


HE HE HE HE HE HE DE HE HE DE DE DE DE DE HE IE HE HE HE DE HE DE HE DE HE HE HE DE HE EE DE DE DE DE HE DE HE HE DE HE HEE HE HE EE HE HE EE EE DE HE EE KE EE EE EE EE EEE 
% NLDMBDST member (NPDA initialization parameters) % 
HEHEHE HEHEHE HEHE HEH HEHEHE HEE IEE EE EE EE DEE EE DE DE EE DE DE EEE DEE IEE DEE EEE EE DE DE EE DE EE EE EEE DE DE EE EEE 

DSTINIT PDDNM=BNJLGPRI 

DSTINIT PPASS=NPDA 

DSTINIT SDDNM=BNJLGSEC 

DSTINIT SPASS=NPDA 

DSTINIT DSRBU=1 

DSTINIT DSRBO=1 

DSTINIT UNSOL=BNJUNSOL 

DSTINIT FUNCT=BOTH 


DSTINIT XITVN=BNJAINTA 
DSTINIT XITCI=AAUSRTEA 
DSTINIT XITDI=AAUINIT 
INITMOD AAUICPEX DSTXIT=BNJAPAMA 
aa ae NPDA initialization cards........ 
HEHE HE HEHEHE HEHE HEHEHE HEHE HEHE HEHE HE HEHEHE HE IE HE HEE HEE EE HE HEE IEE IE IEE EE IE EE DEE IE DE IK DE DE DE DE DE DE DE 3K IK DE DE DE DE OK 3K DE DE DE DE 3K 34 3 DE 
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Add two new members AAUPRMLP and DSTPRMLU ta DSIPARM library 


HEHE HK HEHE IE IE HE HE DE DE HE HE DE IE HE HE IE HE HEHE DE DE IK HE HE IE IE DE HE HE DE HK HEE DE I HE HE DE DE IE HE HE HE DE IE HE DE DE DE IE HE HE HEE HEHEHE MK KH 
% AAUPRMLP member CNLDM initialization parameters) xX 
HEHEHE HEHE IE HE HEHE IEE HEHE EE HE HE IE IE HEE IE IE HE HEHE HE EI HE HE IE HE HE DE IE IE DEK IE IEE HE HE HEHE IEE HE HE EEE HE HE HE HEE EEE HHH 

DSTINIT PDDNM=AAUVSPLP 

DSTINIT PPASS=userpass 

DSTINIT SDDNM=AAUVSSLP 

DSTINIT PPASS=userpass 

DSTINIT FUNCT<=VSAM if NPDA |=BOTH if not NPDA) 

DSTINIT DSRBO=10 

<DSTINIT UNSOL=AAUDCPEX if no NPDA> 
<DSTINIT XITCI=AAUSRTEA if no NPDA> 

DSTINIT XITVN=AAUAINTA 

DSTINIT XITDI=AAUINIT 

INITMOD AAUICPEX MAXSOL=<nnn|50> 

INITMOD AAUICPEX CNMITASK<=BNJDSERV if NPDA |=AAUTSKLP if not NPDA> 

INITMOD AAUINLDM AMLUNAME=ISTPDCLU 

INITMOD AAUINLDM MAXTRACE=<nnn]|100> 

INITMOD AAUINLDM MAXEND=<nnn1|100> 

INITMOD AAUINLDM BUFSIZE=<nnk]4K> nn < 32K 

INITMOD AAUINLDM TRACELU=<NO| YES> 

INITMOD AAUINLDM TRACESC=<NO| YES> 

INITMOD AAUINLDM KEEPSES=<nnn]|10> 

INITMOD AAUINLDM KEEPPIU=<nnn| 10> 

INITMOD AAUINLDM KEEPDISC=<nnn] 250> 


HEHE HE HEHEHE DE HE HE DEDEDE HE HEE HE HEE IE HE HE EE EE DE DE DE IE HEE DE IE HE DEE HE HE HE IE DEE IE DE DE DE DE DE HE HE DE EE DE EE EEE EEE EEE 
* DSIPRMLU member (NCCF LU initialization parameters) * 
HEHE HE HEHE DE DE HE HEE DE HE HE DE HE HE HEE EE HE HEE EE EEE IE HE HE EEE HE EE IE EE EE HE EE EE HE EE EE EE EEE EEE EEE EEK HK 

DSTINIT FUNCT=OTHER 

DSTINIT XITDI=DSILINIT 

CDRMDEF cdrmnamel=nccfidl 

CDRMDEF cdrmname2=nccfid2 


eoee3eo+ovrteee##eo#%eee#ew%e##eegefeee#s#e # @ 


DHE HE HK HE HE HE HE HE HE HE HE HE HE HE DE HE HK HE IE DE HE DE IE HE HE HE HE HE DE EE DE DE IK IE DE DE DE DE IE HE HE DE DE SE FE HE DE DK DE DE DE IE DE DE DE HE DK DE DE DE HE EE HE EEK HEHE 


DEFINE THE NLDM DATA BASES 


HE HE IE DE HEE DE HEE EE EE EE HE EE EK IE HE EE HE HE DE DE HE DE DE EE DE HE DE DEE DE EE DE DE DE DE DE HE DE DE DE DE DE HE DE DE DE DE DE DE EE EE HE EEE EEE 
x NLDM data bases definition JOB x 
HEHE HEHE HEHE HE HE HEHE EE HE EEK IE HE HE EK EEE EE HE EH EEE EH EEE HE HEE HE IEEE HE HE HEE EE EE EEE EE EE EE EEK 
//DEFPLP EXEC PGM=IDCAMS,REGION=500K 
//SYSPRINT DD SYSOUT=A 
//5SYSIN DD xX 
DELETE Cprimary-cluster) PURGE CLUSTER 
DEF CLUSTER CNAMECprimary-cluster) - 
INDEXED - 
UNIQUE - 
RECSZ(102 4086) - 
KEYS (54 0) - 
UPDPWCuserpass)) - 
DATA - 
CFSPCOnn nn) - 
CISZ(6144) - 
CYLINDERS(nn nD) - 
VOLCxxxxxx)) - 
INDEX - 
(CISZ€1024) - 
IMBED - 
REPLICATE —- 
CYLINDERS(nn nd - 
VOLCxxxxxx)) - 
DELETE (Csecondary-cluster) PURGE CLUSTER 
DEF CLUSTER CNAMECSecondary-cluster) - 


INDEXED - 

UNIQUE - 

RECSZ(102 4086) - 

KEYS €54 0) - 

UPDPWCuserpass)) - 
DATA - 


CFSPCCOCnn nn) - 
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CISZ2(6144) - 
CYLINDERS(nn n) — 
VOL Cxxxxxx)) - 
INDEX - 

€C€ISZ01024) - 
IMBED - 
REPLICATE - 
CYLINDERS(Cnn n) - 
VOLCxxxxxx)) - 

7¥ 

HE HE HE HE HE DE HE DE DE HE HE DE HE DE HE HEE OE HE HE DE HE DE DE HE DE DE HE DE DE HE DE DEE DE HE DE DE DE DE DE DE HE DE OE HE DE DE HE DE HEE DE HE DE DE HE DE HE HEE DE HE EE EE EE HE 


UPDATE THE NCCF START PROCEDURE 


HE HE HE HE IE DE DE HE HE EE HE HE HEE HE HE DE HE HE EE EE HE HE HE DE EE HEE HE DE HE SEE EE DE EE EE EE ME EE EE HE EE EE HE EE HE EE KE HE HE EE EE HEH 
add to the existing STEPLIB DD cards 

// DD DSN=SYS1.NLDMLIB,DISP=SHR,UNIT=SYSDA 

add the DD cards corresponding to the NLDM data bases 

//AAUVSPLP DD DSN=primary-cluster,DISP=SHR, 

// AMP="AMORG, BUFNI=nn,BUFND=mm'! 

/Z7AAUVSSLP DD DSN=secondary-cluster, DISP=SHR, 

// AMP="AMORG, BUFNI=nn, BUFND=mm' 


The values for BUFNI and BUFND should be chosen as follows: 


BUFNI = NLDM DSRBOt25 
BUFND = NLDM DSRBOt1 


DEFINE THE NLDM APPLICATION TO ACF/VTAM 


UPDATE THE NCCF APPLICATION PROGRAM MAJOR NODE to reflect the NLDM 
application 


HE HK HEHE HE HE HEHE HE HE HE HE HE HE HE HE HE HE HE HE HE NE HE HE HE HE HE DE HE HE HE HE SE HE HE EE DE HE HE HE HE EEE HE HE EE DE HE DE DE EE IE HE HE DE DE DE EE HE HE EE EEE 
% ACF/VTAM application program major node % 
HE HE HE HEE DE HE HE HE DEE HE HE HEE DEE HEE IE IE I EE DE HE HEHE EE HE KE EE EE EE EE EE EE HE HE HE HE IE IE EE HE DE DE HE EEE EE EE EEE HH 
AAUTSKLP APPL AUTH=CNM 


DSIAMLUT APPL AUTH=CACQ),VPACING=1 
HEHE HK HE HE HK HEHE HEHE DE IE HE HE HE HE HE HEHE DE DE DE HH HK DE HK HEHE EH HH HE HE DE HEHE HK HK HK HK HE HEH HH HE HE DE DEH HE HE HE IE HE DE IEEE HH 


UPDATE THE CNMI ROUTING TABLE MODULE ISTMNGCOO 


St 2 o. 2.2 0.0.0. 0.0, 0, 0.0,0,0,.0, 0,9, 5,0,0,0,0,0,0,0,0,0,5,0,0,0,0,0,0,5,0,0,0,90,0,0,5,5,0,0,5,0,0,0,0,5,0,0,0,9,0,0,0,0,0,0, 0.0.0.0. 0.0.50) 


X ISTMGCOO0 MODULE x 
HE HE HE HE HE HEHE HE HK EE HE KK DEE DE DE EE IK DE DE DE DE IE EEE DE DE DE DE DE DE IKE DEK DE EE IK HE DEE KK HK HEE EE HE DE DE DE DE DE DE DE DE DE DE DE EEK 
7745M EXEC PGM=IFOX00,PARM=OBJ 


/S/SYSLIB DD DSN=SYS1.MACLIB, DISP=SHR 
//SYSUT1 DD DSN=&&SYSUT1,DISP=VI0O,SPACE=(1 
7/SYSUT2 DD DSN=&&SYSUT2, DISP=VI0O,SPACE=(1 
//SYSUT3 DD DSN=&&SYSUT3,DISP=VI0,SPACE=(1 
7/SYSPRINT DD SYSOUT=A 

“7/SYSPUNCH DD DUMMY 

7/SYSG0 DD DSN=&&OBJSET, UNIT=SYSDA,SPACE=(80,(200,50)), 
7 DISP=(MOD,PASS) 

//SYSIN DD x 

ISTMGC00 CSECT 


a a ie | 
oo a2 
ooe 
~ we 
r~ oe FX 
WGN 
aoe 
aooes 
ww ~~ . 
Ul Ue 
oo o 
ww UY CS 
Ne “ed Wed 


DS OF 

DC X'0003' NUMBER OF ENTRIES IN THE TABLE 

DC X*000C' LENGTH OF EACH ENTRY 

DC XL4¢'00000000' RESERVED 

DC AL4'00000000' RESERVED 

DC XL1*O00' FLAGS FOR NPDA ACF/VTAM R2 
x CNMI 

DC XL3'010381' RECMS 

DC C*BNJDSERV' MUST APPEAR IN APPL STATEMENT FOR 
% VTAM WITH AUTH=CNM 
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DC XL1"00' canes FOR NPDA ACF/VTAM RELEASE 2 
CNMI 


¥% 

DC XL3°'410384' RECFMS 

DC C'BNJDSERV' MUST APPEAR IN APPL STATEMENT FOR 
* VTAM WITH AUTH=CNM 

DC XL1'00' FLAGS FOR NLDM ACF/VTAM RELEASE 2 
* CNMI 

DC XL3'410384' RECFMS 

DC C'AAUTSKLP' MUST APPEAR IN APPL STATEMENT FOR 
X VTAM WITH AUTH=CNM 

END ISTMGCO0 : 
//LKED EXEC PGM=IEWL,PARM=CXREF,LET,LIST,NCAL,REUS), 
17 COND=(8,LT,ASM) 


//SYSUTI DD DSN=&&SYSUT1,DISP=VIO,SPACE=(1024,(50,20)) 

7/SYSPRINT DD SYSOUT=A 

//SYSLIN DD DSN=&&OBJSET,DISP=COLD, DELETE) 

//SYSLMOD DD DSN=SYS1.VTAMLIBCISTMGC00),DISP=SHR 

HE DE HE 3 I HE DE DK HE HE 3 HE HEE HK HE IE DE HK HEE DK DEE DE HK HEED HE EEE OE HE DEK HE EOE OK HE DEK HEE DEK HE OE DE HK HE EH HE EEK KH 


CHANGE THE NUMBER OF VTAM PIU TRACE BUFFERS (module ISTRACON). VTAM 
allocates two trace buffers of the size specified in member AAUPRMLP. 
If you want to change this number, change VTAM module ISTRACON. 


LS 2.2.0 0.0. 0.0,0,.0.0,.0,0.0,0,0,0,0,0,0,0,0,0,0,.0,0,0,0,0,0,0,.0,0,0,0,0,.0,0,.0,0,0,0,0,0,0,0,0,0,9,. 0.0.0. 5,0,5,0,0,0,.0,0,0,0,0,0, 0,0, 0,0,5): 


as ISTRACON MODULE * 
3 HE 3 EH HE DE HEE DE DE DE DK DK DE HE HE DE DE DE DK DK DK DE HE DE DE DE DE DK DK DE HE HE HE DE DE DE DE DE KH HE HE DE DEK HK HK HE DE DE DE DE DEK EK HK HM HEH 
/7Z4P EXEC PGM=IMASPZAP 
//SYSPRINT DD SYSOUT=A 
//SYSLIB DD DSN=SYS1.VTAMLIB,DISP=SHR 
7 SYSIN DD x 
NAME ISTRACON 
VER 0024 02 
REP 0024 ON 
1% 
HEHE DE DE I DE HEHEHE DE DE DE I DK HE IEE DE DE DE DK DK HEE 3 DE DE DE DE DK IK HE DE HE HE DE BE DE IK DK DE DE OE EE DE DK DK HE HE HEE DE DE DE DE DE OE KE EE DEE 


NCCF CONSIDERATIONS 


The NCCF disk/tape LOG facility can be used to record the NLDM users, the 
error messages,all NCCF commands entered by the network operator and sub- 
sequent responses. | 

NLDM uses NCCF logon authorization facilities. Several NCCF parameters 
are involved in NLDM initialization, cross-domain support, or operation: 


DSIDMN MEMBER OF THE NCCF PARAMETER LIBRARY CNCCF system parameters) 


NLDM INITIALIZATION 


e the name of the command list, from the DSICLD library, to be exe- 
cuted at NCCF initialization 


NCCFIC IC= 

NLDM CROSS-DOMNAIN SUPPORT 

e the application program name which identifies NCCF to ACF/VTAM 
NCCFID DOMAINID=nccfid 


and used in the NCCF start domain command, in CDRMDEF statements 
or in the NLDM set domain command 


° the maximum number of operators from alternate domains who may 
have sessions at one time with this NCCF 


CDMNSESS n/0 
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the domains which can be started by a GLOBAL operator, with their 
resources 


necfid RRD nodename,...... 
the maximum number of SPAN names to be handled by this NCCF 
MAXSPAN n70 


NLDM OPERATION 


the type of logon authorization checking 

OPTIONS VERIFY MINIMAL/NORMAL/RACF 

the maximum number of times an invalid logon 1s processed 
MAXLOGON n/73 


the network resource names of devices that may be hard-copy 
davices 


HARDCOPY name used by the NLDM copy command 


OPERATOR'S ASSOCIATED PROFILE (see Figure 20 on page 70) 


NLDM CROSS~DOMAIN SUPPORT 


the operator's authority: 


GLOBAL if he can control any resources in this domain and start 
any domain defined in RRD statements 


SPECIFIC if he can control only those resources designated by 
ISPAN and SPAN statements and start domains designated tn 
DOMAINS statement CISPAN establishes the initial 
environment,SPAN defines the environment which can be started by 
command) 


NLDM OPERATION 


the eligibility to receive the messages associated with logon, 
lost terminal or undeliverable messages (MSGRECVR=YES) 


the name of the hard-copy log device CHCL=....) 


the name of the command list executed immediately after logon 
CICS 3436) 


the access to a subset of commands anda subset of their keywords 
COPCLASS) 
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DSIPARMCDSIOPF) DSIPRFCENV1) 


userid OPERATOR PASSWORD= ENV1 PROFILE HCL= ,IC= 
PROFILEN ENV1 AUTH CTL=SPECIFIC,MSGRECVR=YES 
END 3 DOMAINS NCCFO1 


ISPAN SPANA,SPANB < 
SPAN SPANC 

OPCLASS 2 

END 


DSIPARM(DSISPN) _ 
>NCP11 SPANLIST SPANA, SPANB< 


CICS11 SPANLIST SPANB< 
LOcil it SPANC 


V 
DSIPARMCDSICMD) ——>DSIVTAMCNCP11) 


NLDM CMDMDL RSC1 TERMINAL SPAN=CSPAND) 
CMDCLASS 2 RSC2 TERMINAL SPAN=CSPANC) 


ALL KEYCLASS 1 
FORCE KEYCLASS 1 
DISABLE KEYCLASS 1 


RSC3 PU SPAN=CSPANA,SPANC) < 
RSC4 LU SPAN=C(CSPANA,SPANB) < 


Figure 20. LOGON DEFINITION STATEMENTS 
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CHAPTER 6. PERFORMANCE CONSIDERATIONS 


The two main areas that require performance evaluation for NLDM are: 
SESSION TRACE 


Session awareness involves one RU from the access method to NLDM per ses- 
sion activation and one per session termination, and therefore is rela- 
tively inexpensive during normal processing. 


Session data involves the capture in virtual storage of each PIU flowing 
in the network for each session being traced. The number and size of 
access method buffers allocated is a tuning consideration of each instal- 
lation. The recommended values of BUFSIZE, for a given maximum number N of 
active sessions traced at a time, are: 


The number of buffers built by ACF/VTAM is contained in module ISTRACON. 
By specifying multiple buffers of a smaller size, the PIU trace can be 
maintained in a smaller area and with less risk of lost PIU data. 


Depending on the network configuration and operating procedures, high 
NLDM activity may be experienced during network startup or restart and 
network shutdown. If the system performance is degraded during these peri- 
ods due to the above factors it may be necessary to turn off, totally or 
Seen NLDM trace activity before activating or deactivating the 
network. 


Data recording 


NLDM I70's take place at session end or on demand (FORCE command). It is 
then necessary to improve VSAM performance when many sessions terminate at 
the same time. Such a situation can appear at NCP deactivation. The stan- 
dard VSAM performance recommendations also apply to NLDM data bases: | 


° keep them separated from heavily used disk files 
x) define the data and index components separately 
e for the data component specify: 


= the space in cylinders with a primary extent large enough to typi- 
cally not use secondary extents, and with sufficient free space. 
Monitor them using LISTCAT. 


= the largest CI accepted by the disk type (12288 for 3330, 18432 
for 3350) 


e for the index component specify: 
= the space in cylinders 


a the CI just large enough to reference one CA of the data component 
€1024 for 3330 and 4096 for 3350) 


= IMBED and REPLICATE 
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e use BUFND Cnumber of data buffers) and BUFNI (number of index buffers) 
in the DD card in the NCCF start procedure (BUFND=DSRBOt1 and 
BUFNI=DSRBUt25). : 


e monitor the data base usage by making regular listings of the catalog 
and interpreting the number of CI or CA splits and the number of 
deleted records. Use the VSAM REPRO function to compress the data 
base when these numbers become excessive. As an alternative do it ona 
scheduled basis, for example whenever you stop NCCF. To improve the 
repro process use 


AMP="BUFND=n,BUFNI=2" (VSAM file) 
or 
DCB=BUFNO=Nn Csequential file) 


for the source and backup data bases, where n is twice the number of 
CI on a track 


If the NLDM data base is defined reusable Cin the DEF CLUSTER state- 
ment use REUSE in place of UNIQUE) then the REPRO function can be done 
during NCCF processing. It is only necessary to stop NLDM operator 
processing CNLDM END command) on all NLDM terminals and to switch to 
the alternate NLDM data base. 


IE HE DE HE DE HE DE IE DE DE DE DE IE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE HE DE DE DE DE DE IE DE DE DE HE DE HE DE DE DE DE DE DE DE DE DE HE DE IE HE IE DE HE HE DE HEE EEK 


¥ NLDM data base reorganization JOB ¥ 
x before: x 
% NLDM END on all NLDM terminals % 
¥ SWITCH AAUTSKLP,S % 


Ett tt tetatatetatetatetatetstateteteketeteketeketatatetatetetatatatateketetatatetatatetekatekatekatetsteketetatakakatetatetatekatekates 
/7PRTCAT EXEC PGM=IDCAMS 
//AAUVSPLP DD DSN=cluster-name,DISP=SHR, AMP=AMORG 
//SYSPRINT DD SYSOUT=A 
//SYSIN DD * | 
VERIFY FILECAAUVSPLP/userpass) 
LISTC ENTRIESCcluster-name) ALL 
“¥* 
//7REPRO EXEC PGM=IDCAMS 
//SYSPRINT DD SYSOUT=A 
//TNPUT DD DSN=cluster-name,DISP=SHR; 
17 AMP="BUFND=n,BUFNI=2' 
//QUTPUT DD DSN=NLDMmmdd,UNIT=TAPE, DISP=CNEW,PASS), 
// VOL=SER=NLDMmm, DCB=(DEN=3,BUFNO=n),LABEL=C,NL) 


//5YSIN DD xX 
VERIFY FILECINPUT) 
REPRO - 
INFILECINPUT/userpass) - 
OUTFILECOUTPUT) 
7% 


/7REPRO2 EXEC PGM=IDCAMS 
//SYSPRINT DD SYSOUT=A 
//TNPUT DD DSN=NLDMmmdd,UNIT=TAPE,DISP=OLD, 
// VOL=SER=NLDMmm, DCB=(DEN=3,BUFNO=n),LABEL=C€,NL) 
//QUTPUT DD DSN=cluter~-name,DISP=SHR, 
// AMP="BUFND=n, BUFNI=2' 
//5YSIN DD xX 
VERIFY FILECINPUT) 
REPRO - 
REUSE - 
INFILEC INPUT) - 
OUTFILECOUTPUT/userpass) 
“¥ 


//7PRTCAT EXEC PGM=IDCAMS 
//AAUVSPLP DD DSN=cluster-name, DISP=SHR, AMP=AMORG 
/Z/SYSPRINT DD SYSOUT=A 
/7S5YSIN DD * 
VERIFY FILECAAUVSPLP/userpass) 
LISTC ENTRIESCcluster-name) ALL 
7% 
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APPENDIX A. NLDM STRUCTURE 


NLDM consists of a command processor that executes under the control of an 
NCCF Data Services Task (DST) and a command processor that operates under 
the control of an NCCF Operator Station Task (OST). There is one OST for 
each NCCF operator who logs on and, therefore, for each NLDM user. 
Figure 21 illustrates the general NLDM control flow: 


AAUTSKLP 
DS T 
Regular 
Command 
Processor > 
DS C P 
< >NLDM 
DB 
< 


XITDI= XITCI= XITVN= 
AAUINIT |AAURSTEA |AAUAINTA 
A 
ACCESS METHOD 

CNMI 
—- SOLICITED 


DELIVER RU 


— UNSOLICITED 
DELIVER RU 


Figure 21. NLDM CONTROL FLOW 


AAUTSKLP is an AUTH=CNM application and is designated in 
the CNM routing table. 


e a regular command processor checks command syntax and operands and 
formats the command for the DSCP. 


e the data services command processor (DSCP) executes the command and 
interacts with the VSAM data base through DSM (for recording, retriev- 
ing and updating see "Data Collection" on page 2), with the CNM inter- 
face (for sending Forward request RU's and for receiving Deliver 
request RU's see later in this chapter), or with both. The maximum 
number of outstanding NLDM requests on CNMI is given by an initializa- 
tion parameter (MAXSOL). The data to be displayed, read from the NLDM 
data base, existing in virtual storage or received from NCP, is sent 
to PSCP. 


© the presentation services command processor (PSCP). The PSCP accumu- 
lates data in a buffer. When there is no more data or when it has 
enough data for a full screen, the buffer is sent to PSM to perform 
the actual display at the user's terminal. 


e The XITDI exit is invoked by the DST during initialization, for each 
card read from the member named as the operand of MEM keyword of the 
TASK statement. 

© The XITCI exit is invoked when an RU is received from the SSCP over 
the CNMI. Its function is to determine whether the RU is for NLDM or 
NPDA. 


e The XITVN exit is invoked if the DST encounters a VSAM open failure 
due to an empty data base. Its function is to supply the first record. 


NLDM provides the information on a session basis. It collects the session 
information from two sources (Figure 22 on page 74): 


e the access method CVTAM or TCAM) 
e the boundary function of NCP 
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and using two data paths established between NLDM and the access method 
during the initialization phase: 


e the CNM interface 


® the LU - LU session between NCCF and ACF/VTAM Cintroduced by an SPE 
for NCCF and an SPE for ACF/VTAM see "Programming Requirements™ on 


page 61) 
> NLDM 
D/B 
5. ¢-? N C 
NCP CNMI > NCCF 
PU|<=====> DST AUTH.OPER. 
< : 


Figure 22. NLDM DESIGN 


The CNMI DST is either AAUTSKLP or BNJDSERV Cif NPDA is 
installed) | 


An application program can use the CNM interface to request and receive 
data from same-domain PUs. The request or command data is imbedded in a. 
FORWARD RU CREQMS 7 with, if a reply is solicited, a procedure-related 
identifier PRID for request/reply correlation). The data or replies are 
imbedded in the solicited DELIVER RU CRECFMS with the corresponding PRID) 
or in an unsolicited DELIVER RU CRECFMS ®, RECMS °?). 


NCCF uses the CNMI, which is a single-thread resource and can be used by 
only one NCCF DST. If NPDA is installed, it uses the CNM interface and it 
runs under its own DST CBNJDSERV). To allow the NPDA DST to pass 
FORWARD/DELIVER RUs between NLDM and CNMI, NLDM provides an exit XITCI for 
the NPDA DST CXITCI=AAURSTEA). 


7 REQuest Maintenance Statistics 
8 RECord Formatted Maintenance Statistics 


9 RECord Maintenance Statistics 
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APPENDIX B. NLDM DATA BASE STRUCTURE 


The NLDM data is organized on an NAU name pair basis. All records have the 
same key structure (54 bytes): 


DOMAINID.NLDMID.KEYID. QUAL 
DOMAINID = 8 bytes domain designation 


NLDMID = X'F5FO0! 
KEYid = 8 bytes 
QUAL = 36 bytes 
where: 
e for KEYID = "DATA 0! MASTER record 
the QUAL is 


SECname PRIname SECadr PRiIadr 
(8) (8) C4) (6) (6) (4) 


There is one master record for each specific NAU name SEC/PRI pair.It 
is a control record for the wrap area and contains: 


= current wrap count (2 bytes) 
= current entry in wrap area (4 bytes + 7 bytes reserved) 
= date/time when this wrap area was last updated (7 bytes) 
= wrap mode indicator (1 byte - bit 0) 
Each master record has associated with it a set of SIR records. 
° for KEYID = "DATA 1' SIR record 
the QUAL is 


SECname PRIiname nn SECadr PRlIadr 
(8) (8) (4) (6) (6) (4) 


The Session Incidence Record (SIR) is created each time a session ter- 
minates. For a specific NAU name pair SEC/PRI, NLDM maintains the num- 
ber of SIRs and a pointer to the current wrap file entry in the 
corresponding master record. Using this pointer the data is sequen- 
tially inserted in the wrap area until the maximum session keep count 
is reached. At that time NLDM will set the wrap mode indicator to 
Yon'. Following this moment, the addition of a new SIR at the end of 
the wrap area 1S accompanied with the deletion of the oldest SIR. In 
this way the number of most recent SIRs 1s limited to the wrap count 
in the master record, value which is updated by the command: 


KEEP nnn SESS namel name2/ALl 

The nn value in the SIR record represents the wrap sequence number. 
An SIR record contains: | 
= a session data bit map (8 bytes) to indicate the presence of: 

— bit 0 - PRI configuration 

— bit 1 - SEC configuration 

— bit 2 - session parameters 

— bit 3 - PRI trace data 

— bit 4 - SEC trace data 
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= session start time (7 bytes) 

= session end time (7 bytes) data 

Each SIR has associated with it a set of SIDs records. 
for KEYID = "DATA 2n' SID record 

with n equal to the SID record type and QUAL being 


SECname PRIname nn SECadr PRIadr mm 
(8) (8) (4) (6) (6) (4) 


A Session Incidence Data Record (SID) is created each time a session 
terminates and represents the data associated with the session. When- 
ever a SID record is created for a specific SIR the appropriate SID 
data bit in the SIR is turned on. The number of SIDsS depends on which 
functions the user has activated for the specific session. The value 
mm represents the data record sequence number. 
There are 4 types of SID records: 
session connectivity data record (CON) 

At least one of these records will always exist. 
= session parameter data record (SPR) 


This record only exists if the customer was tracing the session at 
activation time 


a access method PIU trace data (TRA) 
This record only exists if the customer was tracing the session 
_ NCP sequence number trace data (NCP) 


This record only exists if the NCP was activated after NLDM 
initialization and the customer was tracing the session 


for KEYID = 'TIME 
the QUAL is 


RES1 | time RES2 RES1I RES2 
name name address! address 


There is an oentry for each different ordered pair of NAUs. These 
records provide a correlation between the time and the data for a giv- 
en NAU Ce.g. a time ordered list of all sessions of a given SLU etc.) 
for KEYID = 'XREF 


the QUAL is 


PRIname SECname 20 bytes X'40' 
(3) (8) 


These records provide secondary-indices Cinverted NAU name ~- PRI/SEC 
- data cross reference key) which are used to form logical relation- 
ships Ce.g. all SLUs for a given PLU etc.) | 
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APPENDIX C. VTAM DISCARD CODES 


DISCARD OVERVIEW 


The VTAM PIU DISCARD reason codes can be found tn the NLDM trace panels. 
Any time the VTAM TSC component cannot forward a PIU towards the final 
destination, a DISCARD trace entry is generated to NLDM. NLDM must be 
active to VTAM to accept the DISCARD PIU and reason code. TCAM also iden- 
tifies discard PIUs to NLDM but without any reason code string. 


Most of the PIU DISCARDs are really not error conditions and should not be 
investigated. The SNA protocols allow for PIU scenarios in which PIUs can 
be discarded without causing any problems in the network. A PIU DISCARD 
should only be investigated if there is an error symptom such as a hung 
condition. 


A description of the NLDM trace panels can be found in the following manu- 
al CNETWORK LOGICAL DATA MANAGER ~- INSTALLATION AND OPERATION, SC30-3165 ) 


FORMAT OF THE DISCARD ENTRY 


< NLDM PIU TITLE HEADER LINE > T 
RRRR,ISTTSxmm YY.DDD 
€ DISCARDED PIU ) D 


RRRR This 1s the reason code associated with the VTAM module. The 
reason code helps identify different discard points and reasons 
within the same VTAM module. 


ISTTSxmm This is the CSECT name of the VTAM module that determined 
the PIU should be discarded. 


IST is the module prefix unique to all VTAM modules 

TS this indicates that the module belongs to the TSC 
component. TSC is the only component in VTAM that sends 
PIU discards to NLDM. 


x is an operating system identifier and may be C or M. 
Both identifiers are interchangeable for the same module. 


mm this identifies the individual module 


YY.DDD This 18s the YEAR and DAY of the year in which the VTAM module 
was assembled. 


D The DISCARDED PIU will always follow the discard reason entry 
with a "D" under the T column. 


All DISCARDS sent to NLDM can be referenced via the following NLDM 
command: 
SESS *¥DISCARD 


This is a special file NLDM has for all discarded PIUs. NLDM will also put 
the discarded PIU into the associated session trace file whenever 
possible. 
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EXAMPLE OF AN NLDM PANEL WITH A VTAM DISCARD ENTRY 


This is an actual scenario of an NCP force inactivate from VTAM. NLDM PIU. 
keep count was set at 10 so only the last 10 PIUsS are recorded. Hex mode 
was set off so that we could see the PIUs formatted. 


SPECIFIC SESSION TRACE DATA PAGE 
PRIMARY =33=3==3-+===- sagan ores a? SECONDARY <<} SSS 3<3Se-<e55 +- DOM 
SA 0000000A EL 0001 | NAME NI03732 SA 00000003 EL 0000 NCOl 
+ + 


FMH. 
FMH. 
FMH. 
FMH. 
FMH. 
FMH. 


FMH. 

DACTPU Sees 
TTSMRO 81.337 
C+)RSP ae 


C 
C 
C 
( 
C 
( 
( 
( 


ay 


END OF DATA 
ENTER SEL# OR COMMAND 


In the previous example the discard entry is select #9 and the discard PIU 
is SEL# 10. Discard code 0001 out of ISTTSCMRO says that the virtual route 
was not active here and the probable cause is post failure traffic purge. 


WVARY NET, INACT,ID=NI03732,F" will cause VTAM to DACTPU the NCP and then 
to INACTIVATE the virtual route without waiting for the DACTPU RESP The 
DACTPU we see at SEL# 8 is an internally generated PIU created by VTAM for 
SON (session outage notification) and simulated to come from the NCP. VTAM 
will generate SON for all sessions that have not come down yet when the VR 
becomes inactive. VTAM's response to the DACTPU, SEQ# 10, is then dis- 
carded because the virtual route is already inactive The PIU discard 
causes no problem here because no one is waiting for the discarded PIU. 
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VTAM DISCARD CODES MEANINGS 


VTAM REASON DISCARD 
MODULE CODE EXPLANATION CPROBABLE CAUSE) 
NOTE: x = M OR C in module name 
¥¥¥¥***M ISTTSxCR 15 connection point manager receive 
ISTTSxCR 1 The request TSCB is a PRI.DT send/SECONDARY DT.RCV 
pending reset state. 
€ TIMING ON LU-LU SESSION TRAFFIC ) 
¥*XX**X¥X ISTTSxIP is the host INN processor 
ISTTSxIP 1 The route was not available to the destination 
€ POST FAILURE TRAFFIC PURGE ) 
ISTTSxIP 2 Cannot generate a response 
( POST FAILURE TRAFFIC PURGE ) 
MXM ISTTSxIS is the inbound session control function interpreter 
ISTTSxIS 1 Discard the Resp when PRI.SESS.SEND is not ina 
pending active state 
€ TIMING ON LU-LU SESSION TRAFFIC ) 
ISTTSxIS 2 Discard the Resp when PRI.DT.SEND is not ina 
pending active state 
( TIMING ON LU-LU SESSION TRAFFIC ) 
ISTTSxIS 3 Discard the Resp when PRI.DT.SEND react state 
€ TIMING ON LU-LU SESSION TRAFFIC ) 
ISTTSxIS 4 Discard the Response when RQR.SEND is not ina 
pending state 
€ TIMING ON LU-LU SESSION TRAFFIC ) 
ISTTSxIS 5 Discard the Resp when PRI.SESS.SEND or SEC.SESS.RCV 
is not in an active state 
€ TIMING ON LU-LU SESSION TRAFFIC ) 
ISTTSxIS 6 INVALID session control response 
( SHOULD NOT OCCUR -—- LU ERROR ) 
RHXHKHMX ISTTSxIU is the host INN utility processor 
ISTTSxIU 1 Link is not contacted and active 
€ POST FAILURE TRAFFIC PURGE ) 
ISTTSxIU 2 No INN extension exits on the NCB 
( POST FAILURE TRAFFIC PURGE ) 
MEX ISTTSxLS is the local 3270 write scheduler 
ISTTSxLS 1 Link not active yet 
€ POST FAILURE TRAFFIC PURGE ) 
ISTTSxLS 2 Request purged due to following session control 


request 


( TIMING ON LU-LU SESSION TRAFFIC ) 
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VTAM 
MODULE 


NOTE: 


KK HHH HEX 


ISTTSxMB 


ISTTSxMB 


ISTTSxMB 


HK HK HHH HN 


ISTTSxNC 
HHH HK KKK 
ISTTSxNS 


HE HHH HK HK HEH 


ISTTSxPI 


KH HK HK HK HHH 


ISTTSxPR 


HH HK HK HH HH 


ISTTSx@D 


HE IEEE 


ISTTSxQP 


HH HK HK HK HK HH 


ISTTSxRA 
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REASON 
CODE 


ISTTSxMB 
1 


ISTTSxNC 
1 


ISTTSxNS 


1 


ISTTSxPI 
1 


ISTTSxPR 
1 


ISTTSxQD 
1 


ISTTSxQP 
1 


ISTTSxRA 
1 


NLDM 


DISCARD 
EXPLANATION (PROBABLE CAUSE) 


x = M OR C in module name 


is the migration bind processor 


This is not a migration route 
€ SHOULD NOT OCCUR - OR ROUTE HAS BEEN REDEFINED ) 


The ICNCB was not found 
€ POST FAILURE TRAFFIC PURGE ) 


The VR number and the TPN in the TH are both not 
zero and should be for migration 
€ SHOULD NOT OCCUR VR AND TPN MUST BE O FOR MIGR. ) 


is the network control function interpreter 


Only the initialization complete request is allowed 
as an inbound request from network control 
€ SHOULD NOT OCCUR - ERROR IN NETWORK ) 


is the no session pab processor 


No processing was required for this FIDO PIU 

( TIMING CONSIDERATION WITH BSC 3270 ) 

1s the path control inbound processor 

The RU size is exceeded and the PIU is not for 
session control 

( LU PROBLEM-THE LU SENT IN A PIU LARGER THAN THE 
BIND SPECIFIED MAXIMUM ) 


is the path control router 


Can not generate a Resp for an INN PIU 
( POST FAILURE TRAFFIC PURGE ) 


is the session deactivation request processor 


Contention ACTCDRM was discarded due to the arrival 
of a DACTCDRM RU from the same subarea. 

€ OPERATIONAL - OPERATOR DEACTIVATION OF CDRM FROM 
ONE HOST AFTER ACTIVATION ) 


is the session deactivation processor 

ACTCDRM contention purge unnecessary ACTCDRM 

€ OPERATIONAL - CDRM ACTIVATED FROM BOTH HOSTS 
AT THE SAME TIME ) 

is the abend recovery routine 

This is not a first in segment PIU 


€ POST FAILURE TRAFFIC PURGE AFTER APPLICATION 
ABEND ) 


VTAM 
MODULE 


NOTE: 


HHH HMMM KN 


ISTTSxRI 


ISTTSxRI 


ISTTSxRI 


HK KKK KKK 


ISTTSxRO 


ISTTSxRO 


HK HK HK HK HK HH 


ISTTSxSA 


ISTTSxSA 


ISTTSxSA 


HRK KK KKK 


ISTTSxTS 


ISTTSxTS 


ISTTSxTS 


ISTTSxTS 


ISTTSxTS 


ISTTSxTS 


REASON 
CODE 


ISTTSxRI 


1 


2 


ISTTSxRO 


1 


2 


x 


1 


i 


DISCARD 
EXPLANATION CPROBABLE CAUSE) 
= M OR C in module name 
s the virtual route path control inbound routine 


The Origin subarea 1s invalid 
( SHOULD NOT OCCUR -—- ADJACENT NCP HAS ERROR )} 


The route is not usable 
( POST FAILURE TRAFFIC PURGE - ER NOT OPERATIVE ) 


Invalid sequence number 
( SHOULD NOT OCCUR - LOST DATA OR LU ERROR } 


s the virtual route path control outbound routine 


Route not active 
€ POST FAILURE TRAFFIC PURGE ) 


The activation number does not match the VR 
Activation number 
( POST FAILURE TRAFFIC PURGE ) 


ISTTSxSA is the segment assembler routine 


1 


ISTTSxTS 


1 
Cc 


The beginning of the PIU segment lost 
€ SHOULD NOT OCCUR -~- NETWORK ERROR ) 


Retransmission of PIU, discard the partial PIU 
segment, 2 first in segments received 
€ SHOULD NOT OCCUR - CHECK OUT LU ) 


Hot I/0, discard all PIU segments on session. 
( SHOULD NOT OCCUR - CHECK OUT LU ) 

s the boundary function transmission control inbound 
hannel attached SNA 3790,3274 


CSSCP,PU).BF.SESS.RCV is not pending active for 
ACTPU RSP. VTAM was not waiting for ACTPU RSP. 
€ SHOULD NOT OCCUR - OUT OF SYNC ON SSCP-PU SESSION ) 


CSSCP,PU).BF.SESS.RCV 1s not pending reset for 
DACTPU RSP. VTAM was not waiting for DACTPU RSP. 
€ SHOULD NOT OCCUR —- OUT OF SYNC ON SSCP-PU SESSION ) 


(SSCP,SLU).BF.SESS.RCV is not pending active for 
ACTLU RSP. VTAM was not waiting for ACTLU RSP. 
€ SHOULD NOT OCCUR - OUT OF SYNC ON SSCP-LU SESSION ) 


CSSCP,SLU).BF.SESS.RCV is not pending reset for 
DACTLU RSP. VTAM was not waiting for DACTLU RSP. 
€ SHOULD NOT OCCUR - OUT OF SYNC ON SSCP-LU SESSION ) 


CPLU,SLU).BF.SESS.RCV is not pending active for 
BIND RSP. VTAM was not waiting for BIND RSP. 

C TIMING BETWEEN SSCP SESSIONS AND LU-LU SESSION, 
SSCP SESSION RESET DURING LU SESSION BRINGUP ) 


C(PLU,SLU).BF.SESS.RCV is not pending reset for 
UNBIND RSP. VTAM was not waiting for UNBIND RSP. 

C TIMING BETWEEN SSCP SESSIONS AND LU-LU SESSION, 
SSCP SESSION RESET DURING LU SESSION TAKEDOWN 2) 
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VTAM REASON DISCARD 
MODULE CODE | EXPLANATION CPROBABLE CAUSE) 


NOTE: x = M OR C in module name 


HHXXNXXXX ISTTSxWNS 315 the communications controller/cluster controller 
write scheduler 


ISTTSxXWS 1 The channel-link has not been contacted. 
( POST FAILURE TRAFFIC PURGE ) 


RHMKKKXX ISTTSxXS is the CTCA write scheduler 


ISTTSxXS 1 The channel-link is not in contacted/active state 
€ POST FAILURE TRAFFIC PURGE ) 


XXX ISTTSx3R the 3270 virtual pu/lu transmission control outbound 
channel attached non-sna 3270 


ISTTSx3R 1 DT.RCV is not active 
C TIMING ON LU-LU SESSION TRAFFIC ) 


ISTTSx3R 2 Session is being reset 
€ TIMING ON LU-LU SESSION TRAFFIC ) 


RMMXHNNXX ISTTSx3S the 3270 virtual pu/lu transmission control inbound 
: channel attached non-sna 3270 


ISTTSx3S 1 No session active or react and session not active 
€ TIMING ON LU-LU SESSION TRAFFIC ) 
ISTTSx35S 2 CSSCP,PU).SEC.SESS.RCV is not pending active for 


ACTPU RESP. VTAM was not waiting for ACTPU RSP. 
€ SHOULD NOT OCCUR - OUT OF SYNC ON SSCP-PU SESSION ) 


ISTTSx3S 3 CSSCP,PU).SEC.SESS.RCV is not pending reset for 
DACTPU RESP. VTAM was not waitin for DACTPU rsp. 
€ SHOULD NOT OCCUR - OUT OF SYNC ON SSCP-PU SESSION ) 


ISTTSx3S 4 (SSCP,SLU).SEC.SESS.RCV is not pending active for 
ACTLU RESP. VTAM was not waiting for ACTLU RSP. 
€ TIMING BETWEEN SSCP-PU AND SSCP-LU SESSIONS ) 


ISTTSx35S 5 CSSCP,SLU).SEC.SESS.RCV is not pending reset for 
DACTLU RESP ; 
€ TIMING BETWEEN SSCP-PU AND SSCP-LU SESSIONS ) 


ISTTSx35 6 CPLU,SLU).SEC.SESS.RCV is not pending active for 
BIND RESP. VTAM was not waiting for BIND rsp. 
€ TIMING BETWEEN SSCP SESSIONS AND LU-LU SESSION, 
SSCP SESSION RESET DURING LU-LU SESSION BRINGUP ) 


ISTTSx3S 7 CPLU,SLU).SEC.SESS.RCV is not pending reset for 
UNBIND RESP. VTAM was not waiting for UNBIND rsp. 
€ TIMING BETWEEN SSCP SESSIONS AND LU-LU SESSION, | 
SSCP SESSION RESET DURING LU-LU SESSION TAKEDOWN ) 


ISTTSx3S 8 DATATRAFFIC_RCV is not active form FM DATA PIU 
( TIMING ON LU-LU SESSION TRAFFIC ) 
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COMMON PROBABLE CAUSE 


COMMON PROBABLE CAUSES EXPLANATION OF PROBABLE CAUSES 


TIMING ON LU-LU SESSION TRAFFIC This can occur on the session 
between the application and the SLU. 
It is usually due to some type of 
reset function from the application. 
For example a CLEAR or a BIND 
can cause this condition. 
There are usually no problems caused 
with this type of discard. 


TIMING BETWEEN SSCP SESSIONS AND This discard usually occurs when a 

LU-LU SESSION reset of the SSCP-PU or SSCP-LU 
effects a pending session initiation 
or termination of the LU-LU session. 
For example : If the application 
issues a CLSDST to the LU, VTAM will 
send out an UNBIND to the LU. If the 
SSCP-LU fails before the UNBIND 
response comes back, then the UNBIND 
response will be discarded. 
There are usually no problems caused 
with this type of discard. 


TIMING BETWEEN SSCP-PU AND This discard usually occurs when a 

SSCP-LU SESSION reset of the SSCP-PU session effects 
a pending session initiation or 
termination of the SSCP-LU session. 
For example: If the operator 
inactivates the LU, VTAM will then 
send out a DACTLU to the LU. If the 
The SSCP-PU session fails before the 
DACTLU response comes back, then the 
DACTLU response will be discarded. 
There are usually no problems caused 
by this type of discard 
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POST FAILURE TRAFFIC PURGE 


COMMON PROBABLE CAUSES 


SHOULD NOT OCCUR 
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NLDM 


EXPLANATION OF PROBABLE CAUSES 


This discard is caused after a 
network failure is initiated. any 
PIU traffic trickling in after the 
network failure but before the 
session is brought down can be 
purged in this way. 

For example: after a channel I/0 
error and before the channel goes 
inactive, PIUs that continue to 
queue up outbound over the channel 
can be discarded for this reason. 
There are usually no problems caused 
with this type of discard. 


This type of discard reason implies 
that there may be a hardware or a 
software error in the network. 

This discard is usually set after 

a major SNA protocol violation. 

For example : If VTAM is waiting for 
a sequence number of 0008 but gets a 
PIU with sequence number of 0010, 
PIUs 0008 and 0009 are missing. 

The two missing PIUsS could have been 
lost anywhere in the session path 

or maybe they were never sent. 

The LU,PU,LINE,NCP,CHANNEL and VTAM 
are all suspects in this example. 


Further investigation is usually 
required to determine where 

the problem is in the network. 

The type of documentation needed to 
resolve a problem identified by this 
discard code will vary depending on 
the session type and the reason code. 
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APPENDIX D. SAMPLE INITIALIZATION CLIST 


The name of the CLIST to be executed at NCCF initialization is indicated 
in the DSIDMN member of the DSIPARM library 


NCCFIC IC=NLDMCLST 
The CLIST itself is a member of the DSICLD library. 


HE HEE HE HE DE DE DE DE DEE DEE DE HE IE DE HE DE DE HE DE HE HE DE HE HE DE IE HE HE DE DE HE HE DE HE IE HE HE IE HEHE IE HE DE DE HE HE IE HE HE EE HE IE IE DE HEE HE HEE HEE EEE HEE 
¥ NLDM initialization CLISTs % 
x allow NLDM initialization before commands are issued % 
HE HE HE HE HE HEHE HE HE DE DE DE HE DE DE DE DE HE HE DE DE EE EE EE EE HE HE HE HE EK EE IE EE EE IE EE EE IE EE EE EE EH HE EE EHH KM MK 


~-7 ADD LIST=ALL,NAME=NLDMCLST 
CLIST 

&CONTROL ERR 

EVERY 2,PPT,ID=TIMER1,NLDMTIME 
& EXIT 


-7 ADD LIST=ALL,NAME=NLDMTIME 
CLIST 

&CQNTROL ERR 

NLDMCMDS 

PURGE TIMER=TIMER1,O0P=PPT 

& EXIT 


-/ ADD LIST=ALL,NAME=NLDMCMDS 
CLIST 
&CONTROL ERR 
&BEGNRITE -VTAM 
VTAM commands to activate the network after NLDM initialization 
-VTAM 
V NET,ACT,ID=name 
&BEGWRITE -NLDM 
NLDM commands to deactivate the NLDM trace and change the KEEPSES 
sian or KEEPPIU values for some sessions 


TRACE STOP namel ALL 

KEEP n SESS namel <name2|ALL> 
KEEP n PIUS namel <name2|ALL> 
KEEP m SESS XDISCARD 

KEEP m PIUS *®DISCARD 

& EXIT 
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APPENDIX E. RELATED PUBLICATIONS 


NLDM PUBLICATIONS 
NLDM GENERAL INFORMATION, GC30-3081 
NLDM INSTALLATION AND OPERATION, SC30-3165 
NLDM DIAGNOSIS, SC30-3166 
NLDM LICENSED PROGRAM SPECIFICATIONS, GC30-9555 


RALEIGH INTERNATIONAL SYSTEMS CENTER TECHNICAL PAPERS 
CNM/CUSTOMIZING NCCF, GG24-1554 
CNM/NCCF TERMINAL ACCESS FACILITY, GG24-1540 
CNM/USING INFO-MANAGEMENT, GG24-1546 
CNM/USING THE CNM-TOOLS, GG24-1561 
CNM/MANAGING INTERCONNECTED SYSTEMS, GG24-1539 
ADVANCED COMMUNICATIONS FUNCTION PRIMER, GA24-1547 
ACF/SNA SYSTEM PROBLEM DETERMINATION GUIDE VOL1, GG24-1514 
ACF/SNA SYSTEM PROBLEM DETERMINATION GUIDE VOL2, GG24-1523 
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APPENDIX F. DEFINITIONS 


AUTHORIZATION MESSAGE. An NCCF message that is directed to an authorized 
operator such as successful logon, logon rejected because of an invalid 
password, a DSM error message, logoff etc. 


AUTHORIZED OPERATOR. In NCCF, an operator who has been authorized to 
receive undeliverable messages, authorization messages and lost terminal 
messages. Authorization is specified on the AUTH statement (MSGRECVR 
operand ) during NCCF definition. 


COMMAND. A request from a terminal to execute an operation or a particular 
program. A command may be entered from a terminal by operator, or gener- 
ated from a command list, or implied in a receive message, or issued by a 
command processor. 


COMMAND PROCESSOR. A program executed to perform an operation specified by 
a command. 


CNM. Communication network management. The process of designing, install- 
ing, operating and managing the distribution of information and control 
among end users of communication systems. 


COMMUNICATION NETNORK MANAGEMENT APPLICATION. An ACF/VTAM application 
program that is authorized to issue formatted management services request 
units containing physical-unit-related request and to receive formatted 
management services request units containing information from physical 
untts. An example is NCCF with associated processors. 


CNMI. Communication network management interface. The interface provided 
to application programs by the access method to acquire information from 
or to send information to physical units in session with the SSCP. The 
application may send Forward request units (RUs) to the SSCP which send 
them to the PU and receive Deliver request units CRUs) from the SSCP which 
have been send by the PU. 


COMMUNICATION NETNORK MANAGEMENT PROCESSOR. A command processor that man- 
ages one of the functions of a communication network management applica- 
tion. It is executed under the control of NCCF and requires NCCF as a 
prerequisite program. 


CTC. Channel to channel attachment. 


DSCP. Data services command processor.An NCCF component that structures 
the request for recording and retrieving data to the data base, performs 
requested data base maintenance services and also structures the request 
to solicit data from a network device. 


DST. Data services task. The NCCF subtask that provides support to gather, 
record and manage data in a VSAM file that contains communication network 
management information. 


DSM. Data services manager. A function in NCCF that provides the interface 
between DSCP's and the CNM interface and/or VSAM services for data storage 
and retrieval. 


FID. Format identification field. A field in the transmission header, TH, 
that indicates its format, that is, the presence or absence of certain 
fields. TH format differ in accordance with the types of nodes between 
which they pass. There are six FID types: 


° FIDO for traffic involving non-SNA devices 

° FID1 for traffic between adjacent subarea nodes when either or both do 
not support explicit route and virtual route protocols 

° FID2 for traffic between a subarea node and an adjacent PU type 2 node 

° FID3 for traffic between a subarea node and an adjacent PU type 1 node 

° FID4¢ for traffic between adjacent subarea nodes when both support 


explicit route and virtual route protocols 
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® FIDF for certain commands sent between adjacent subarea nodes when 
both support explicit route and virtual route protocols (e.g. for 
transmission group control) 


INFO/MANAGEMENT. A component of INFO/SYSTEM consisting of transactions 
which help an operator to enter data into the INFO/MANAGEMENT data base 
concerning problem, change and configuration management. 


NCCF. Network communication control facility.A program consisting of a 
base for communication network management processors that can monitor, 
control and improve the operation of a data communication network. 


NAU. Network addressability unit. In SNA, a logical unit, a physical unit 
or a system services control point. It is the origin or the destination of 
information transmitted by a path control network and. Each NAU has a net- 
work address. 


NPDA. Network problem determination application.A CNM processor that 
assists the user in identifying communication network problems from a cen- 
tral control point using interactive display techniques. NCCF is a prereq- 
uisite. 


NTO. Network terminal option.A product that extents the capabilities of 
the ACF/NCP to support certain non-SNA: devices. 


OCCF. Operator communication control facility.A program designed to run 
with MVS or VSE, and NCCF. It intercepts messages from MVS or VSE and 
application programs and responds automatically with pre-coded actions. 
Is implemented as a set of transactions in NCCF. 


OST. Operator station task.An NCCF subtask that establishes and maintains 
the on-line session with the network operator. There 1s one OST for each 
network operator who logs on to NCCF. 


PSCP. Presentation services command processor.An NCCF component that 
receives and process user requests and initiates DSCP action or receives 
user requested data from DSCP, formats it to display and send it through 
PSM to the user terminal. 


PSM. Presentation services manager. A function in NCCF that provides the 
interface between PSCP's and the user terminal. 


SPE. Small program enhancement. 


SSCP. System services control point. A NAU that provides configuration, 
maintenance, management, and session services via sessions with physical 
units, logical units, and other SSCPs. It also provides services for the 
network operators who control the configuration. 


TAF. Terminal access facility.A feature of NCCF Release 2 that lets NCCF 
operators interact with screen oriented applications on CICS/VS, IMS/VS, 
TSO, remote NCCF systems and through HCF with 8100/DPPX. 


TARA. Threshold analysis and remote access feature.A NPDA feature that 


records, analyzes and displays systems management data collected through 
the CNM/Controller Support of the 3600 System Monitor. 
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INTERPRETATION OF BIT SETTINGS IN 
THE RU 


BB begin bracket 

CD change direction 

DR definite response 

EB end bracket 

ED enciphered data 

ER exception response 

FC first in chain 

FMD function management data 
FMH function management header 
LC last in chain 

MC middle in chain 

NR no response 

NSH network services header 

OC only in chain 

PAC pacing 

PD padded data 

Q queued response 
ABBREVIATION OF THE BTU COMMAND 
CH SPEED change modem speed 


CONT ID contact with return 
resource identification 


CONT NRM contact normal 


COPY DEV copy device session infor- 
mation 


COPY DST copy destination node 


COPY SES copy § session 
information 


DISC EOC disconnect with end of 
call 


DISC E&I disconnect with end of 
call and invite 


DISC INV disconnect with invite 
DISC NRM disconnect normal 

DSP STAT display line status 

INV ASRT invite with auto restart 
INV BLK invite block 


initiation 


GLOSSARY 


INV DISC invite transmission with 
disconnect 


INV MSG invite message 

INV NORM invite normal 

INV PERP invite perpetual 
INV TRAN invite transmission 
LPDA TST LPDA test interrupt 


MOD BLK modify block handler’ set 
associate 


OVER ADD override session address 


PHY DISC physical disconnect 


RD BLK read block 

RD DISC read transmission discon- 
nect 

RD INV read with invite 

RD MSG read message 


RD NORM read normal 

RD TRANS read transmission 

REP SESS replace session initi- 
ation information for a 
line 

RST COND reset conditional 

RST CONT request control mode reset 

RST DEV reset device queues 

RST EOC reset at end of command 

RST ERR reset error lock 

RST IMMD reset immediate 

RST OLTT reset online terminal test 


RPL DEV replace device 
information 


SET ADDR set session address 


session 


SET DEST set destination mode 
SW BKUP switch to backup 


SW PRI switch from backup to pri- 


mary 
TST DEV test device 
TST LINE test line 
WRT CONT write with contact 
WRT DISC write with disconnect 
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WRT EOM write with end of message 


WRT EOT write with end of trans~- 
mission 


WRT INV write with invite 

WRT NORM write normal 

WRT READ write with read Cimplied 
EOT 3) 


WR/C DIS write with contact and 


disconnect 


WR/C EOT write with contact Cim- 


plied EOT) 

WR/C ETX write with contact Cim- 
plied ETX) 

WR/C RD write with contact = and 
read 


NCP CONTROL BLOCKS 
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AXB adapter control block exten- 
sion : 

CCB character control block 

block 


CUB common physical unit 


(SDLC) 
DVB device base control block 
IOB input output block 
LCB line control block 
LKB line control block (SDLC) 
LUB logical unit control block 
LXB link XIO control block (SDLC) 


PSB SSCP-NCP physical services 
block 
SNP SSCP-NCP session control 


block, one for each concurrent 
session 


otaples can cause problems with automated mali sorting equipment. 


Note: 
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